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NOTE 


SOFTWARE PERFORMANCE REPORT 

If you have any problem or discover any inadequacy in your DOS software 
or its documentation, please report it using the Software Performance 
Report forms enclosed in your software kit. 

Give the Software Performance Report to your DEC Software Special- 
ist. In most cases he will be able to provide an immediate answer to 
your problem, as he is kept informed of new information as soon as it 
becomes available. If yours is an original problem, the Software 
Specialist will ensure that all necessary details, examples, and support- 
ing material are included in the Report, and then he will forward the 
complete report to DEC'S Software Information Service Group in Maynard, 
Massachusetts for a thorough investigation of your problem. As soon as 
the investigating programmer has the answer to your problem, it will be 
sent to you via the Software Specialist. 

This procedure is intended to provide fast replies to your Soft- 
ware Performance Reports either by an immediate answer from your Soft- 
ware Specialist or as the result of concentrating our software mainte- 
nance effort on well-documented original problems. 

Your inputs are most appreciated in our continuing effort to 
improve our software, and with your help our commitment to good software 
support will remain apparent. 

If you have any questions on this procedure, please contact your 
Software Specialist. 


READER'S COMMENTS CARD 

Your attention is invited to the last page of this document. The 
"Reader's Comments" page, when filled in and mailed, is beneficial to 
both you and DEC; all comments received are acknowledged and are con- 
sidered when documenting subsequent manuals. 
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PREFACE 


Chapter 1 explains, using step-by-step instructions, how to build 
the PDP-11 Disk Operating System (DOS) . We suggest that you read this 
chapter before building your first system. This reading should clarify 
the purpose for performing certain steps in the building process as 
well as familiarize you with the entire process. 

Chapter 2 contains programming notes and techniques which reveal 
short-cuts and other helpful information for added programming 
efficiency. 


Chapter 3 is a detailed description of the DOS Monitor DECtape 
Setup and Update Program (MODS) . MODS can be used to copy the 
SYSLOD . SYS and MONLIB.SYS programs from the delivered DECtape onto a 
back-up DECtape. 

Chapter 4 can be used to update existing system manuals to 
describe the current versions of the system programs. 


This document assumes familiarity with the PDP-11 system, DOS 
Monitor, Link-11 Linker, and PIP File Utility Package. 

DOCUMENTATION CONVENTIONS USED HEREIN 


1. All command strings are terminated by typing the RETURN key; this 

is standard, and not shown in most examples since the key does 
not print on the teleprinter. Where necessary, the symbol J is 
used to represent the RETURN key. : ' 

2. Monitor prints a period (.) or dollar sign($) to which the 
command string is typed. System programs print a number sign 
(#) to which the command string is typed. 

For clarity, these symbols have been underlined when the command 
strings they precede are typed by the user. 

3. The CTRL/C key combination is typed by holding down the CTRL key 
while typing the C key; t C prints on the teleprinter. CTRL/C 
ensures that the Monitor will accept the next command, but will 
not necessarily immediately stop a job in progress. 

4. In certain examples, sysdev: is used to represent the system 
device name of the particular installation's system disk, i.e., 

DK ; , DF : , and DC : . 
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CHAPTER 1 


BUILDING THE DISK OPERATING SYSTEM 

1.1 INTRODUCTION 

The PDP-11 Disk Operating System (DOS) software is delivered on either 
paper tape or DECtape. The system software consists of the following 
programs, identified as shown below. 

Monitor Modules SYSLOD.SYS 

MONLIB.SYS 

System Load Modules PIP .LDA 

LINKOB.LDA 
LINK 11. LDA 

System Object Modules PIP .OBJ 

LINKOB . OBJ 
LINK11.0BJ 
EDITH. OBJ 
ODT11R.OBJ 
LIBRll . OBJ 
PALOB .OBJ 
PAL 11R. OBJ 
PALS YM. OBJ 
MODS .OBJ 

Source Module PALSYM.PAL 

(Building and running PDP-11 FORTRAN under the DOS is described 
in GETTING FORTRAN ON THE AIR, DEC-ll-SFDB-D. ) 

The DOS Monitor is available in three major versions; each is 
tailored to run on a particular disk: RK11, RF11, or RC11. There 
are two versions for the RK11 disk: one for high-density (2200 BPI) 
and one for low-density (1100 BPI) . The procedures for building 
the DOS differ slightly, depending on the disk that is to be used as 
the systems device. Section 1.4 describes how to load the system 
programs on the RK11 and RF11 disks. Section 1.5 describes how to 
load the system programs on the RCll disk. 

Briefly, the suggested sequence of operations in building DOS 
is : 

1. Load the System Loader (SYSLOD.SYS) . 

2. Load and run the DOS Monitor (MONLIB.SYS) . 

3. Link the system object modules into load modules. 


(DECtape only) 


(DECtape only) 
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The newly-built DOS should be backed up by transferring a copy 
of the load and overlay modules onto paper tape or DECtape (see 
Section 1.6) . MODS can be used to transfer the System Loader and 
Monitor from DECtape to DECtape (see Section 1.6.2 and Chapter 3). 

This chapter contains operating procedures in a step-by-step 
fashion. It does not explain the purpose of each step as they are 
described in the DOS Monitor, Link-11, and PIP manuals. 

1.2 LOADING THE SYSTEM LOADER AND DOS MONITOR 

The System Loader (SYSLOD.SYS) is used to load and start the DOS 
Monitor (MONLIB.SYS) . SYSLOD has been delivered on paper tape; and 
for systems with DECtape, it has been placed on DECtape for more 
automatic loading. To load the SYSLOD program into core, proceed to 

Section 1.2.1 for paper tape 

Section 1.2.2 for DECtape 

1.2.1 Loading SYSLOD from Paper Tape 

The SYSLOD program is loaded from paper tape using the Bootstrap and 
Absolute Loaders: 

1. Toggle the Bootstrap Loader into core using the console 
Switch Register as shown on the PDP-11 Instruction List 
card. 

2. Set the ENABLE/HALT switch to HALT. 

3. Place the Absolute Loader paper tape in the proper reader 
(as specified by the Bootstrap Loader) . The special 
leader code (351) must be over the read sensors. 

4. Set the Switch Register to xx7744, where xx is as 
specified in Step 1 above. 

5. Depress the LOAD ADDRess switch. 

6. Set the ENABLE/HALT switch to ENABLE. 

7. Depress the START switch. 

The Absolute Loader is read into core. 

8. Place the SYSLOD.SYS tape in the proper reader with blank 
leader tape over the read sensors. 


CAUTION 

When placing paper tapes in the reader, ensure 
that blank leader tape is directly over the 
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the read sensors . When the name of the 
program is punched on the leader , blank 
tape separates the name from meaningful 
data. Exception : 

Absolute Loader tape has special 
leader code 351 which must be 
over the read sensors . 

9. Set the ENABLE/HALT switch to HALT. 

10. Set the Switch Register to xx7500, where xx is as 
specified in Step 1 above. 

11. Depress the LOAD ADDRess switch. 

12. Set the ENABLE/HALT switch to ENABLE. 

13. Depress the START switch. 

The SYSLOD program is read into core and halts at location 30462. 

Any other halt is an error; start again at Step 8 above. (See 
Section 1.7 for an explanation of SYSLOD error halts.) 

The SYSLOD program is in core. Go to Section 1.2.3. 

1.2.2 Loading SYSLOD from DECtape 

The SYSLOD program is automatically loaded from DECtape using the 
BM792-YB ROM Bootstrap Loader. (Users without the BM792-YB must load 
SYSLOD from paper tape . ) 

1. Mount the DECtape containing SYSLOD. SYS on DECtape 0. 

2. . Set the REMOTE and WRITE LOCK switches on DECtape 0. 

3. Set the ENABLE/HALT switch to HALT. 

4. Set the Switch Register to 173100. 

5. Depress the LOAD ADDRess switch. 

6. Set the ENABLE/HALT switch to ENABLE. 

7. Set the Switch Register to 177344. 

8. Depress the START switch. 

The SYSLOD program is read into core and halts at location 30462. 

Any other halt is an error; start again at Step 1 above. (See 
Section 1.7 for an explanation of SYSLOD error halts.) 

The SYSLOD program is in core. Go to Section 1.2.3. 

1.2.3 Loading the DOS Monitor 

There is one Monitor for the RF11 disk and one for the RC11 disk. 
However, there are two Monitors for the RK11 disk: a high-density 
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(2200 BPI) and a low-density (1100 BPI) version. Ensure that the 
Monitor is the one tailored for your disk. 


CAUTION 

Check to ensure that the disk write protection is 
disabled, i.e., not on. Operation of the write 
protection switch (s) is explained in the 
appropriate hardware maintenance manual. For 
RK systems, the cartridge must be on Unit 0. 


Regardless of whether SYSLOD was loaded from paper tape or DEC- 
tape, the DOS Monitor (MONLIB.SYS) can be loaded from either paper 
tape or DECtape. Go to: 


Section 1.2.4 for paper tape 

Section 1.2.5 for DECtape 

1.2.4 Loading MONLIB from Paper Tape 

The DOS Monitor is on four paper tapes, labeled: 

MONLIB.SYS V004A TAPE n OF 4 


where n is the number giving the sequence in which the tapes are to 
be loaded. The loading procedure follows. 


1. Set Switch Register bit 0 down (to 0 position) . 

2. Set Switch Register bit 15: 

down to replace the Monitor only 

up to clear (zero) the entire disk, which 
must be done when building on a new 
(fresh) disk. 

3. Place the properly numbered MONLIB.SYS tape in the reader 
with blank tape directly over the read sensors. 

4. Depress the CONTinue switch. The tape is read in. With 
bit 15 up (to 1 position) , the first MONLIB tape reads 
in about 4 inches and pauses while the disk is being 
cleared. 

5. At the end of the tape, SYSLOD halts at location 30120. 
Any other halt is an error (see Section 1.7). 

6. Repeat Steps 3, 4, and 5 for each MONLIB.SYS tape in the 
sequence specified by the tape number. 

7. Set Switch Register bit 0 up (to 1 position) . 

8. Depress the CONTinue switch. 
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The Monitor is booted into core and prints: 


MONITOR VB04A 


Now log in as explained in Section 1.3. 

1.2.5 Loading MONLIB from DECtape 

When loading the DOS Monitor from DECtape: 

1. Mount the DECtape containing MONLIB. SYS on DECtape 0. 

2. Set the REMOTE and WRITE LOCK switches on DECtape 0. 

3. Set Switch Register bit 0 up (to 1 position) . 

4. Set Switch Register bit 15: 

down to replace the Monitor only, 

up to clear (zero) the entire disk, which must be 
done when building on a new (fresh) disk. 

5. Depress the CONTinue switch. 

With bit 15 up (to 1 position) , the DECtape spins and then pauses 
while the disk is being cleared. 

The System Loader loads the Monitor from DECtape to disk and 
halts at location 30120. Any other halt is an error (see Section 1.7). 

If -any paper tapes are to be loaded (Monitor patches, etc.), set 
bit 0 down and follow the procedure in Section 1.2.1, Steps 3 through 
8. If no tapes are to be loaded: 

6. Depress the CONTinue switch again. 

The Monitor is booted into core and prints: 

MONITOR V004A 
S' 

Now log in as explained in Section 1.3. 
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1.3 LOGGING IN 


Log in under User Identification Code 1,1 as shown below (The 
user types command strings in response to Monitor's . or $.): 

_^LUu 1,1 

Lfrtii-;- c.l-UZ.C-1? 

T IdiiJ - 
4 ) 

Monitor responds by printing a meaningless date and time. Use the 
DATE and TIME commands to enter the correct date and time. However, 
if the system does not contain a KW11-L Real-Time Clock, the TIME 
command is not necessary. For example: 

S r 'a T 3 A - JUL “71 
ST I ME ! T.j/’P 


You are now "on-the-air" with the DOS Monitor. System programs 
should now be loaded from paper tape or DECtape to the disk. 

Section 1.4 for RK11 or RF11 disk 
Section 1.5 for RC11 disk 

1.4 BUILDING SYSTEM PROGRAMS ON THE RK11 OR RF11 DISK 

The DOS system programs can be loaded on the disk from either 
paper tape or DECtape. 

Section 1.4.1 for paper tape 
Section 1.4.2 for DECtape 

1.4.1 Building from Paper Tapes on the RK11 or RF11 Disk 

Briefly, the process is as follows: Run the Link-11 Overlay 
Builder, LINKOB.LDA, and then the Link- 11 load module, LINK11.LDA. 

Use Link-11 to link PIP. OBJ into a load module on the disk where it 
can be used to transfer the required system object modules from paper 
tape onto the disk. The object modules can then be linked into load 
modules using Link-11. 


NOTES 

Command strings should be typed in response to 
the underlined ^ and £ and £ characters exactly 
as shown below unless otherwise indicated. All 
command strings are terminated with the RETURN 
key . 
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1. Place the LINKOB.LDA tape in the reader and type: 


SRUN PR: 

2. Place the LINK11.LDA tape in the reader and type: 

a. 8K systems : 

SGET PR: 

S.SAVE LIMK.LDA 
SEE 

b. 12K to 28K systems : 

SHUN PR: 

Link-11 loads into core, starts automatically, and prints: 
LINK- 11 V005A 


PASS 1 

# 

3. Place PIP. OBJ TAPE 1 OF 2 in the reader and type: 

a. 8K to 16K systems : 

_#P I p. LBA< FR : / CC/ TA: 2/ E 

b . 20K to 28K systems : 

£PIP.LDA<PR:/CC/TA:2/T: 77A7A/E 
CAUTION 

Do not link PIP. OBJ higher than the top 
of 16K, i.e., with 20K or more, use the 
command string in b. above. 

At end of tape, Link-11 prints: 

A002 063320 
£ 

4. Place PIP. OBJ TAPE 2 OF 2 in the reader and type: 

SCO 


Link-11 prints the load map (an example is shown below) and pauses 
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TRANSFER ADDRESS: O22A0A 
LOW LIMIT: 021612 
HIGH LIMIT: 037060 

PASS 2 

AO 02 063320 


5. Place PIP. OBJ TAPE 1 OF 2 in the reader and type: 


SCO 


Link-11 prints: 


AO 02 063320 


6. Place PIP. OBJ TAPE 2 OF 2 in the reader and type: 

SCO 


PIP. OBJ is now linked into a load module, PIP.LDA, on the disk. 
Link-11 prints: 


LINK- 11 v 0 0 5 A 
PASS 1 


7. Return to the Monitor by typing the CTRL/C key combination, 
clear core with the KILL command, and RUN PIP: 


£ T C 
• ai 

SHUN PIP 


FIP-11 V 0 O A A 


Use PIP to transfer the required object modules from paper tape to 
disk. 

8. Place the paper tape (identified as shown in the command 
Strings below) in the reader and type: 
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#LIMKOB«OBJ<PR:/FE 


£L INK 1 1 . 0 E J< PR : / FB 


(Not required for 8K systems) 


#EDIT1 1 •OBJ<PR:/FB 


#LIBF.l 1 .OBJ<PP:/?B 


#PALOB.OBJ<PR:/FB 


#PAL1 1R»0BJ<PR:/FB 


i- PAL S YM . 0 B«J< PR : / F B 


9. Return to Monitor, clear core, and run Link- 11; 

_#t c 

_.KI 

a. 8K systems , type ; 

SHU N LIMK 

b. 12K to 28K systems , place LINK11.LDA tape in reader 

and type: 


SRIEnJ PR; 


Link-11 -prints : 


LI.^JK-11 VR05A 


PASS 1 

# 


10. Link the required object modules to the top of available core 
(except PIP. OBJ) using the command strings shown below (use the TOP 
switch to link elsewhere) . 


NOTE 

The load maps printed by Link-11 are not shown 
here since the format is similar for all links, 
and the data varies with the core size of the 
system and with the TOP switch when used. 
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(Not required for 
systems) 


s' L I N KO E < L 1 M KO E.OEJ/E 


j?LINK<LINKl 1.03J/E 

LINKOB and LINK11 must always be linked to 
the exact same HIGH LIMIT (see load maps) . 


“EDI T<EDI T1 l.Gr,J/r: 


-L I FE<L I EH 1 1.0EJ/L 


# PALO E< PALO B.OEJ/E 


£ p AL < PAL 5YM. OBJ# PALI 1R.QEJ/ L 

11. Return to Monitor, clear core, and RUN PIP: 

Jt C 

• KI 

SLUM FIP 


PIP- 11 VPOAA 


12. Direct PIP to list a brief directory of the files on the disk 
(an example is shown below) : 

7 ,' / 


Dr ^ z 

MONL I n 
L INK 1 1.0 VR 
LINK • LDA 
PIP .LDA 
EDIT1 1-OBJ 
LIBE1 1 * OBJ 
PALOE • OE 0 
PALI 1P.0EJ 
PALSYM.GEJ 
EDIT .LDA 
LI DR .LDA 
PALOE .LDA 
PAL .LDA 

13. Delete all object modules from the disk: 

#*.0PJ/DE 
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If you plan to debug user programs using 0DT-11R, PIP the tape 
labeled 0DT11R.0BJ from paper tape to disk: 

14. Place 0DT11R. OBJ tape in reader and type: 

#0DT1 1R.0BJ<PP:/F£ 

15. Return to Monitor ,. clear core, and RUN LINKOB and PALOB: 

#tc 

• K I 

SHUN LINKOB (Not required for 8K systems) 

SHUN PALOB 

16. RUN PIP and get a full directory of the newly-built Disk 
Operating System (an example is shown below) : 

SHUN PIP 

PI P-11 V004A 

f • / D I 


DIRECTORY DF 0: C 1 * 1 3 


m- XXX- 72 


MOMLIB 

50SC 

00- XXX- 70 

<377> 

LINK1 1.0 VR 

36C 

00- XXX- 72 

<233> 

LINK • LDA 

60 

l? IS- XXX- 7 2 

< 2 00> 

PIP .LDA 

70 

00-XXX-72 

<£33> 

ODT 1 1R.0EJ 

hii 

00- XXX- 72 

< 2 3 3> 

PALI 1R.0VR 

40C 

0P-XXX-72 

<233> 

EDIT .LDA 

56 

00- XXX- 7 2 

< 233> 

LIBR .LDA 

35 

00-XXX-72 

< 233> 

PALOB .LDA 

1C7 

0P- XXX- 72 

<233> 

PAL .LDA 

65 

00-XXX-72 

< 233> 

TOTL BLKSs 

1021 



TOTL FILES: 
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Now run the newly-built DOS by assembling PALSYM.PAL (the source 
of the PAL-1 1R symbol table) . 


17. Return to Monitor, clear core, place the PALSYM.PAL tape in 
the reader, and assemble the source as shown below: 
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#tc 

^KI 

_SF,IW PAL 

PAL IIP; V00 5A 

A PAL SYM<P P : PAL SYM • P AL 


HMD 

A002 063322 

c 

18. Place the PALSYM . PAL tape in reader again, type CTRL/C, and 
then the continue command: 


! T c 
^CO 

onneon EPROPS 

The symbol table was assembled without errors. There is now a 
file named PALSYM. OBJ on the disk; delete it using PIP. 

19. Return to Monitor, clear core, RUN PIP, and delete PALSYM. OBJ: 

#t 0 

_• K 1 

vPti.i PIP 

-IF- 11 VYiA 
_APALSYM.OF J/L£ 

A back-up system should now be created as explained in Section 1.6. 
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1.4.2 Building from DECtape on the RK11 or RF11 Disk 

Briefly, the process is as follows: Use PIP to transfer required 
object modules from DECtape to disk. Use Link-11 to link the object 
modules into load modules . 

In the following examples an RF11 disk is assumed; with an RK11 
disk, use DKO : wherever DFO: appears. 

NOTES 

Command strings should be typed in response to 
the underlined ^ and £ and £ characters exactly 
as shown below unless otherwise indicated* All 
command strings are terminated with the RETURN 
key . 

1. Mount the object module DECtape on Unit 0 (ensure that the 
REMOTE and WRITE LOCK switches are set on DTO : ) , then load and run 
PIP.LDA from DTO: 

a. 8K systems : 

.SUET DTO: PIP* LEA 
SSAVE- PIP.LDA 

b . 12K to 28K systems : 

SPUN DT o : p I P • L DA 

PIP prints : 


PIP- ii V0P4A 


2. Transfer required object modules from DTO: to disk: 

a. 12K to 28K systems : 

£DF P: < DT0: F I P.OBJ* L I>iK OP* 03 J* L INK 1 1 • OH J 

b. All systems : 

#DK ft; <DTPiS EBIT1 1 • OBJ* L I BR1 1 •OBJ* FALO E • uFJ 

A DEC : < DTP : PAL SYM • OBJ* PAL 1 1 PI. OBJ* MU L-S.CFJ 
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3. Return to Monitor by typing the CTRL/C key combination, clear 
core with the KILL command, and run LINKOB.LDA and LINK11.LDA: 

£T G 

. r 

a. 8K systems : 

Sr u>i L'T G ; L I A Ku H . L DA 

ft FT ETHsLI MX J 1 . LDA 

_r SAVE L IMF. LEA 

b . 12K to 28K systems : 

I?. U A L'T nsLI A KO B . L DA 
IF UA DT OjLI'JKU.LDA 

Link-11 loads into core, starts automatically, and prints: 

LI.'JK-ll VFG5A 
PASS 1 


4. Link the required object modules to the top of available core 
(except PIP. OBJ) using the command strings shown below (use the TOP 
switch to link elsewhere) . 


NOTE 

The load maps printed by Link-11 are not shown 
here since the format is similar for all links, 
and the data varies with the core size of the 
system and with the TOP switch when used. 

CAUTION 

Do not link PIP. OBJ higher than the 
top of 16K, i.e., with 20K or more, 
use the command string in b. below. 

a. 12K and 16K systems : 

• P I F < 1 r • J / G G / n 

b . 20K to 28K systems : 


*PIP<r'IP.0do/0C/Tl77474/ »- 
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c. All systems ; 


#L INKOB<L IMKOB*OB J/ t. 


*L I NK<L IoJ K 1 1 . 0 B J/ E 


r* (Not required for 8K systems) 


LINKOB and LINKll must always be linked to 
the exact same HIGH LIMIT (see load maps) . 


#EDIT<F.DIT1 1 .OBJ/E 

#L I ER<L I BE 11.0 B J/ E 


# PALO B< P ALO E . 0 B J/ 2 


JjPAL< PALSYM. 0 BJ* PAL 1 1 R. 0 BJ/ E 
JHO DS<M0 DS-OEJ/E 

5. Return to Monitor, clear core, run PIP, and delete all object 
modules from the disk: 

£1 C 

_»KI 

SHUN FTP 


PI P-11 V0P4A 
OBJ/DE 

6. Transfer 0DT11R.0BJ and PALSYM.PAL from DTO : to disk: 

£DF 0: < DT0 : 0 DT 11 R. 0 BJ* PAL SYS • P AL 

7. Return to Monitor, clear core, and RUN LINKOB and PALOB: 

It c 

• Y. I 

SHUN LINKOB (Not required for 8K systems) 

_SRL r N PALOB 

8. RUN PIP and get a full directory of the newly-built Disk 
Operating System (an example directory is shown below) : 
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FI F 


PIP- 11 V0P4A 
-/I I 


DIRECTORY DrC: C 1 > 1 3 
r.(T- vyv- 7 o 


XOMLIF 

50 SC 

0 0— XXX- 7 0 

< 3 7 7 > 

0 DT 1 1 F. • 0 r J 

53 

O 0- XXX- 7 8 

<233> 

PALSYX. PAL 

85 

80- XXX- 78 

<233> 

LINK 1 l.GVf? 

36C 

00- XXX- 72 

< 233> 

PALI 1R.0VE 

40 C 

on- XXX- 72 

< 233> 

FIP . L DA 

70 

p: r.- yyy_ y p 

<£33> 

LIMKOF-LDA 

96 

nfo— y— ^2 

< 233> 

LINK . L DA 

59 

00- XXX- 72 

< £33> 

EE IT • L DA 

56 

. y p 

<233> 

LI PH .LLP 

35 

00- XXX- 72 

< 233> 

PAL OF -LLP 

107 

FT— XXX- 7 8 

< 23 3> 

FPL • LT;£ 

65 

,*?. r-yyy- 7 p 

<233> 

MODS .LDP 

3 0 

p ,p- wv- 7 0 

<835> 

TOTL ELKS: 

1 PAP 



TOTL FILES: 

1 3 




Now run the newly-built DOS by assembling PALSYM.PAL (the source 
of the PAL- HR symbol table) . 


9. Return to Monitor, clear core, RUN PAL, and assemble PALSYM.PAL 
as shown below: 


£T C 
*_XI 

_£_F UN PPL 

PALI IP VP 05 A 

# P A L S YM < F AL S YM • PAL 


END 

PP0000 F.FFOFS 

The symbol table was assembled without errors. There is now a 
file named PALSYM.OBJ on the disk; delete it using PIP. 
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10* Return to Monitor, clear core, RUN PIP, and delete 
anri PATiSYM.PAL from the disk : 


#t C 

.KI 

SHUN PIF 


FIP-U V0P*A 

SYY . 0 BJ* PAL SYM. PAL/ DE 

A back-up system should now be created as explained in Section 1,. 6. 
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1.5 BUILDING SYSTEM PROGRAMS ON THE RC11 DISK 


Briefly, the Link-11 load module, LINK11.LDA, is run from DECtape 
and then used to link required system object modules from DECtape to 
disk. Note that DECtape is required when the RC11 is the only disk in 
the system. 

NOTES 

Command strings should be typed in response to 
the underlined ^ and £ and £ characters exactly 
as shown below unless otherwise indicated. All 
command strings are terminated with the RETURN 
key . 

1. Mount the object module DECtape on Unit 0 (ensure that the 
REMOTE and WRITE LOCK switches are set on DTO : ) , then load and run 
LINKOB.LDA and LINKll.LDA from DTO: 

a . 8K systems : 

DTP' : LINKUP. LI A 

L T n : L I A 1 1 • L 1 ' - 
L I -i • LI A 

b . 12K to 28K systems : 

r_u. v J Ui n : L I -\! Ku E • L LA 
JTU.n! DTP': LINK 1 1 «L DA 

Link-11 loads into core, starts automatically, and prints: 

LIsiK-ll VHP5A 
= A S S 1 

2. Link the required object modules to the top of available core 
(except PIP. OBJ) using the command strings shown below (use the TOP 
switch to link elsewhere) . 


\i 

C t-W 7 

P P A \ r. 


NOTE 

The load maps printed by Link-11 are not shown 
here since the format is similar for all links, 
and the data varies with the core size of the 
system ana with the TOP switch when used. 
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CAUTION 



top of 16K, i.e., with 2GK or more, 
use the command string in b. below. 


a. 12K and 16K systems : 

£P IP • L DA< JDTUs PIF* OBJ/CC/ E 

b. 20K to 28K systems : 

API ?• L DA < I.-T : P I P . 0 H .}/ C C / T : 7 7 * 7 /• / - 


c. All systems : 

jrL INKOP< DT0 • L I B* 0 EJ/ n. 

#L INK< DTG 8 L I N K i 1 .OBJ/E 


s (Not required for 8K systems) 


LINKOB and LINK11 must always be linked to 
the exact same HIGH LIMIT (see load maps) . 


f E D I T < D T C : SLIT 1 1*0 E J / L 


£L I BP <DTC:LI E F, 1 1 • 0 E J/ E 
£PAL0 B< DT ?: : PALO B • 0 E J/ E 
#PAL< DTD : PAL SYM • 0 EJ> PAL 1 1 F . 0 E J/ E 


£M0 DS < ETC : X0 DS • 0 D 0/ X 

3. Return to Monitor by typing the CTRL/C key combination, clear 
core with the KILL command, mount a fresh DECtape on DECtape Unit 2, 
and use PIP to ZEro DT2 : (the back-up DECtape): 

£t C 
KI 

a . 8K systems : 

r/i '•••pip . la 
P I P • L L- 

b . 12K to 28K systems : 

5EUX PIP 


S.L-F'I 

SSAVE 
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PIP loads into core , starts automatically, and prints: 


PIP- 11 V0O4A 
£DT2: /ZE 

4. Return to Monitor, clear core, run MODS, and copy SYSLOD.SYS 
and MONLIB . SYS from the supplied DECtape (DTO : ) to the back-up DECtape 
(DT2 : ) : 


£t c 

• KI 

3 POM MODS 

MODS- 11 V0P3-A 
£DT2:<DT0: 

5. Return to Monitor, clear core, run PIP, and copy the follow- 
ing load modules onto DT2 : 

*■» o 

_SFU'J PIP 

PI P-11 \ 


a. 8K systems : 

£DTP:<lTO : L I Jp. L i A > J LT IIP. JE a* PALSY/ • FAL 
£1)T? : < P I P • L DA i L I i a . L LA 

b. 12K to 28K systems : 

£D79. S < DTPS : 0 L>T 1 Ip.OFJ* PALSY/ . PAL 
# D T 2 : < L I M K 0 P . L U A. .> F I P • L l A ,LIM K .Li, A 

c. All systems : 

_£ r, T 2 : < K L IT* L DA iLI EP • L I L? AL 0 ~ . L I A * PAL* L L - > • ... I S • L L A 

6. Delete the following load modules from disk: 

#L I 'J K.LDAjE D I T • L DA* L I EF: • L L A > P AL . L DA > MO I . S . L , ( , P I F . L I A / i E 
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7. Return to Monitor, clear core, and run LINKOB.LDA and 
PALOB.LDAr 


_#tC 
• K I 

J_POM LINKOB.LDA (Not required for 8K systems) 

5 RUN PALOB.LDA 

8 . Run PIP from DT2 : 

SHUN DT 2 : P I P 

PI P-11 V00AA 

a. 8K systems , delete PALOB.LDA from disk: 

#P ALG E • L DA/ DE 

b. 12K to 28K systems , delete LINKOB.LDA and PALOB.LDA 
from disk: 

±L I \i KO E . L DA , FALOE . L L A / L'£ 

9. List a full directory of the disk and back-up DECtape 
(example directories are shown below) : 

#DC0: > I)T2:/DI 


DIRECTORY DC0: Cl* 13 
30- JUL-71 

MOMLIE 2SAC 00- XXX- 70 <377> 

LINK11.0VR 36C 30-OUL-71 <233> 

PAL 1 1 P* OVR 40C 30-JUL-71 <233> 

TOIL ELKS: 360 

TOTL FILF.S: 3 


(directories continue on next page) 
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DIRECTORY DT2 

: [D 

1 3 


36- JUL-71 




SYSLOD. SYS 

3 1 C 

30- JUL-7 1 

< 377> 

MONLIB. SYS 

84 

30- JUL-71 

< 3 7 7 > 

LWKOn.LDA 

24 

30- JUL-71 

< 233> 

ODT 1 1R.OEJ 

1 3 

30- JUL-71 

<233> 

PAL SYK • PAL 

21 

30- JUL-71 

<2 33> 

PIP * L DA 

17 

30- JUL-71 

<233> 

LINK • L DA 

lb 

30- JUL-71 

< ?33> 

EDIT • L DA 

14 

30- JUL-7 1 

< 233> 

LIBR • L DA 

9 

30- JUL-71 

< 2 3 3 > 

PA-LOB • L DA 

27 

30- JUL-71 

< 233> 

PAL . L DA 

17 

30- JUL-71 

<233> 

MODS • L DA 

8 

30- JUL-7 1 

< 233> 

FREE BLKS: 

282 



PrFE FILES: 

4 4 




The PDP-11 DOS is now ready for use. Run PAL from DT2 : and 
assemble PALS YM. PAL (the source of the PAL-11R symbol table) . 

10. Return to Monitor, clear core, RUN PAL, and assemble as 
shown below: 

Ft o 

•_K I 

_SRU>J DTP: PAL 

PAL HR VCW5A 

# PAL S YM< DTP: PAL S YK . P AL 


tJ'j D 

000000 ERRORS 

The symbol table was assembled without errors. There is now a 
file named PALSYM.OBJ on the disk; delete it using PIP. 

11. Return to Monitor, clear core, RUN PIP from DT2 : , and 
delete PALSYM.OBJ: 

£t C 

• K I 

SPUN DT 2 : P I P 
PIP- 11 V004A 

^PALSYM.OBJ/DE 


1-22 



1.6 CREATING A BACK-UP SYSTEM 

A copy of the newly-built DOS can be transferred from disk to 
paper tape or DECtape. This back-up system is then available to 
facilitate building subsequent systems if necessary, or it can be used 
to transfer a fresh copy of any system load module into core or onto 
the disk. 


1.6.1 On Paper Tapes 


To be backed up with paper tapes, RUN PIP and transfer a copy of 
any disk file (excluding MONLIB and overlay files, OVR) onto punched 
paper tape. For examples: 


SRUM PIP 


PI P-11 A 

_#PP : < ED I T • L EA 
#?P:<LIFF«L DA 
_rPF:<?AL.LLA 

and etc. 

Each paper tape punched should be labeled immediately after it is 
removed from the punch bin. 


1.6.2 On DECtape 


All files of the newly-built DOS can be transferred to a back-up 
DECtape. MODS is used to copy SYSLOD and MONLIB from DECtape to DEC- 
tape, and PIP is used to copy source, object, load, and overlay files. 


1 . 

2 . 

3. 

4. 

5. 

6 . 

7. 

8 . 
9. 


Dial a DECtape transport to Unit 2. 

Mount a fresh DECtape on DT2 : . 

Set the REMOTE and WRITE ENABLE switches on DT2 : . 

RUN PIP. 

ZEro DT2: using PIP. 

RUN MODS. 

Copy SYSLOD. SYS and MONLIB. SYS onto DT2 : using MODS. 
RUN PIP. 

Copy all or any disk file onto DT2 : using PIP. 
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The printout might appear as shown below when transferring all 
disk files and SYSLOD and MONLIB onto DT2 : 

:-FUM PIP 


"IP- II 

±LT2:/ZE 

-t C 

• K I 


F-PLN M OLS 


_ i T '? t < }>TP : 

_f V, 

. y. i 


pip 


PIP- II V^'^A 

’ 1. *1 y. • < ^ • L* i_ A » ' ' • _• . t.I * t' • rrLj * _r V i 1 / L ■«/ 

# 

1.7 RECOVERING FROM SYSTEM HALTS 


1.7.1 SYSLOD Error Halts 


When a system loading error is detected, the SYSLOD program halts 
at the address shown in the console ADDRESS REGISTER with a display in 


the DATA register. The halts can 

Halt DATA 

Address Display 

30222 2 

3 

4 

31570 (RK11 high) 

31624 ( RK11 low) 

31620 (RF11) 

31600 (RC11) 


be interpreted as follows: 


Input data error. 

File open error (possibly a 
wrong tape was mounted) . 

Load tape format error. 

Read error occurred in trying 
to read the Monitor into core 
from disk. 


Generally, when an error halt occurs the program must be reloaded 
However, in the case of mounting the wrong tape (DATA=3) , mount the 
correct tape (with MONLIB, start over with the first tape) and press 
the CONTinue switch twice - -loading should resume correctly; otherwise 
reload SYSLOD. SYS. 


1-24 



1.7.2 Halts While Linking 


When the linking process is interrupted by a system error (Snnn) , 
the cause is often due to: 


1. The filename already exists on the directory. The user can 
use PIP to either specify a different filename in the command 
string or remove the filename from the directory with the 
UNlock and DElete commands, and then link again. 

2. A bad read. The user can use PIP to UNlock and DElete the 
filename from the directory, and then link again. 


Note that Link-11 enters the filename in the directory and then 
attempts to link the module. 


1.7.3 Fatal Error Halts 


When a fatal error message (Fnnn) is printed the system program 
is suspended. In most cases the BEgin command will restart the sys- 
tem program. If this fails, type CTRL/C followed by the KILL command 
and then restart the system program with the RUN command. 

When the keyboard is locked, restart the Monitor as explained in 
Section 1,8.2. 


1.8 RESTARTING THE MONITOR 


1.8.1 From Keyboard 

The user can, at any time, restart the Monitor with the Finish 
command. For example, when a programming session is concluded with 
the FI command, the Monitor is automatically restarted for another 
session. Unless the last character on the teleprinter is a $, the 
KILL command should precede the FI command. Printout might be: 



5r I 

TIME:- 

MONITOR V0O4A 


The user should then log in (see Section 1.3) under his UIC and 
issue the desired Monitor command. This type of restart does not 
alter file directories, date, or the time clock. 
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1.8.2 From Disk or DECtape 


The BM792-YB ROM Bootstrap Loader can be used at any time to load 
a fresh copy of the Monitor into core from disk or DECtape. (Users 
without the BM792-YB must load SYSLOD from paper tape, as explained 
in Section 1.2.1.) 

1. Set the Switch Register to 173100. 

2. Set the ENABLE/HALT switch to HALT. 

3. Depress the LOAD ADDRess switch. 

4. Set the Switch Register to: 

177406 for RKll systems 
177462 for RF11 systems 
177450 for RC11 systems 

5. Set the ENABLE/HALT switch to ENABLE. 

6. Depress the START switch. 

A fresh copy of the Monitor is booted into core and prints: 

MOM I TOP v A 

5 

Log in with the appropriate UIC. This type of restart does not alter 
file directories; date and time must, however, be re-entered. 

A fresh copy of the Monitor can be booted into core from DECtape 
as explained from Section 1.2.2 onward. 
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CHAPTER 2 


AND CAUTIONS 


2.1. DOS MONITOR, V00 4 A 
2.1.1 Programming Notes 

1. The Monitor expects to be able to write on any part 
of a disk surface, therefore, the write protection 
must be disabled. In particular, the user should be 
careful to ensure that the appropriate switches are 
correctly set at times when there is no resident Moni- 
tor in core to produce the proper error diagnosis 
(i.e., during SYSLOD or a Monitor boot). Otherwise 
the system will not operate. 

2. If it is desired to copy a DECtape containing SYSLOD, 
it is necessary to use either a block-by-block DECtape 
copy program or the MODS program (see Chapter 3). The 
nature of the SYSLOD file does not allow its being 
copied by PIP, i.e., it is a position-dependent con- 
tiguous file. 

3. When the attention message A002 is printed by the 
Monitor because of a DECtape not ready situation, it 

is safe to dial the DECtape (by rotating the thumb switch) 
to the proper drive number; unless the faulting request 
is OPENO, and the message is due to the requested drive 
being in WRITE LOCK status, and you wish to dial another 
transport to the drive number currently requested. In 
this one instance the directory of the DECtape has al- 
ready been read by the Monitor and the Monitor is unaware 
that the dialing took place. Therefore, the directory of 
the latter tape will be garbled. 

4. If CTRL/C is typed immediately following the RETURN key, 
the Monitor will echo the 1 C and hang — a Monitor re- 
start is required. A very slight hesitation (blink your 
eyes) after typing the RETURN key is all that is neces- 
sary to circumvent this problem. 
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5. It is legal to type a command to the Monitor at any 
time. However, if you are giving a command to the 
Monitor when it detects a situation requiring a di- 
agnostic message (e.g., an OPEN failure in a running 
program while you are typing CTRL/C TI) , a conflict 
for the swap buffer will result which causes the 
Monitor to hang. If this happens, a Monitor restart 
is required. 

6. The use of the BEGIN command after a program failure 
requires some care. As far as possible the Monitor 
tries to clean up for the user by closing any input 
files currently open for input and deleting any files not 
yet completely created. The Monitor employs its own methods 
for doing this rather than using normal file-structured 
operations, because these operations would attempt to 
write to the relevant device data stored in core which 

must be suspect following the program crash. In parti- 
cular, no attempt is made to change bit maps as perma- 
nently recorded. This can mean that on disks which 
use several bit maps to cover their surface, some blocks 
allocated to the files being deleted will not be released 
for further use, even though the files themselves have 
been removed. A series of crashes can thus lead to the 
disk being filled, although other evidence appears to 
contradict this. The user should therefore consider 
whether he should chance disk-corruption and use KILL 
rather than BEGIN and then delete the incomplete files 
with PIP. It also follows that if the automatic dele- 
tion effected by BEGIN could lose irrecoverable data 
to the user, he should again KILL after a crash. 

7. If the system crashes to the extent that rebooting 
the Monitor from scratch is the only recourse, the 
user must be aware that when a file is opened for cre- 
ation, its initial directory entry is made immediately. 
However, it is only when the file is closed that all the 
blocks allocated to it are permanently recorded as such. 
Because of the crash, the file may not be closed; some 
blocks given to it will still remain free and might be 
used for some other purpose. Nevertheless, the initial 
directory entry still exists and the only way to remove 
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it is by deletion, which includes release of all 
blocks associated with the file. If the deletion 
is not done immediate l y after the crash ^nd before 
any other operations are carried out, it is possible 
that disk-corruption can ensue. It can be avoided 
only by the user doing the necessary clean-up as 
soon as convenient. 

8. The Monitor includes drivers for RF11, RKll, and 
RC11 disks, and the CR11 card reader, as well as 
those available in earlier versions. The RF11 and 
RCll Drivers are quite straightforward. The RKll 
Driver expects all its associated units to be set 
up for high-density usage, except when the resident 
system device is the low-density cartridge. The CRll 
Driver is suitable for reading only ASCII cards, though 
these may originate from either 026 or 029 punches; and 
the user has the option of requesting suppression of 
columns 73-80 and trailing blanks in preceding columns. 

However, the sources for both these drivers 
(which are available from DEC's Program Library) 
contain conditional assembly features to alter 
their usage if required. The Monitor also contains 
the necessary links for the driver for MT11 Magnetic 
Tape which will be available shortly. 

9. Another edition of the DOS Monitor Programmer's 
Handbook (DEC-ll-MWDB-D) is available. The user's 
attention is drawn particularly to the changes 
listed below: 

a. Change in SPECIAL FUNCTIONS CALL 

b. Extension of MODIFY command 

c. Introduction of new code under EMT 41 for 
requesting System Device Name 

d. Differentiation between ASCII and Binary 
in TRAN call 

e. Invalid code error in EMT 42 

10. This release of the Monitor has the following discrepancies 

with the DOS Monitor Programmer's Handbook as published;: 

a. No files are deleted on Finish, regard- 
less of their protection codes 
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b. M acro calling f or M onitor operations is 
not yet possible. The user must instead 
directly expand the sequences required 
in basic assembly language. 

c. The only valid device accepted by console 
DUmp command is the line printer (LP:). 

11. By its nature a dataset, other than one being up- 
dated, can supply input or accept output but not 
both simultaneously. Therefore, it is not possible 
to issue READ and WRITE commands to the same dataset 
at any one time and obtain meaningful results. 
Because a device, such as paper tape reader or 
punch, normally forces uni-directional requests or 
because the device is treated as file-structured, 
an appropriate OPEN command must be issued and this 
forces the direction. The Monitor provides the 
necessary checks in these cases. However, it does 
not presently protect the user of the Teletype, 
which is bidirectional and not file-structured. 

READ and WRITE on the same dataset will be accepted 
but will then cause invalid operations. The user 
must exercise caution by making two datasets 
available or, if the same dataset is used, 
logically changing the direction by : OPEN, 

READ, CLOSE, OPEN, WRITE, CLOSE. 


12. The following bugs are currently known to exist in this 
version of DOS Monitor 4A) . 

a. When the system disk is RK11, an attempt to access 
a disk block outside the range of the disk surface 
(i.e., greater than 4800 on a high-density cartridge 
or 2400 on a low one) will cause the system to hang. 

If this should occur, reboot the Monitor. 

b. If more than one output file is concurrently opened 

on an RK11 disk on any unit other than 0, it is highly 
likely that that disk's directory structure will be 
corrupted when the files are closed. For the present, 
users should restrict their usage of disks on these 
units to one output file at a time. 

c. Occassionally it has been found that transferring 
card files to DECtape under PIP, where the blank supp 
suppress oftion for cards is exercised, can cause 
garbage data to be added to the end of the output 
file. Until this problem is rectified, the user 

can remove the garbage via the Editor. 
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2.1.2 Reserved Filename Extensions 


The filename extension is a convenient means of storing information 
about the attributes of a file. DEC reserves the following extensions 
for use by DEC-supplied PDP-11 system programs. Additional extensions 
may be pre-empted for our use as the need arises. 

TABLE 2-1 


Reserved Filename Extensions 


Extension 


Attribute 

ALG 

* 

ALGOL source file 

BAS 


BASIC source file 

BAR 

** 

Backup file 

BLI 

** 

BLISS source file 

CBL 

* 

COBOL source file 

CMD 


Command file 

CRF 


Input to cross-referencing program 

DAT 

** 

DATA file for FORTRAN job 

DDT 


Reserved for DDT 

FTN 

** 

FORTRAN source file 

FCL 

* 

FOCAL source list 

LBO 

** 

Library of object modules (other types 
of libraries may also be implemented) 

LDA 

** 

Load module. Absolute 

LDR 

** 

Load module, Relocatable 

LOG 

** 

Logging file 

LSP 

* 

LISP source file 

LST 

** 

Listing file 

MAC 


MACRO assembler source file 

MAP 

** 

MAP file 

MFD 


Master file directory 

OBJ 

** 

Object module 

OPR 

** 

Program generation information 

OVR 


Overlay 

PAL 

** 

PAL assembler source file 

PL1 

* 

PL/I source file 

RNO 

* * 

Input for RUN-OFF program 

RPG 

* 

RPG source file 

SNO 

* 

SNOBOL source file 

SPC 

* * 

SPEC format text 

SYM 


File of symbols 

SYS 


System management 

TMP 

** 

Temporary scratch file 

UFD 


User file directory 


* Just in case we ever need them. 

** Used now or in the very near future 

Unstarred items may be used in the near future. No 
definite plans. 


2.1.3 System Use of UIC's 

The UIC is composed of two 8-bit fields and is represented as two 3- 
digit octal numbers whose values are less than or equal to 377. Thus, 
[2,316] is a legal UIC. The first field is referred to as the project 
number; the second field is the proarammer number. 
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The following UIC's are reserved for use with DEC software. In- 
stallations should not use these UIC's for any purpose other than those 
purposes stated in DEC documentation. 

Project numbers: 0-17 and 377 

Programmer numbers: 0-17 and 377 

Thus, the following are among those reserved: 

[ 2 , 210 ] [ 1 , 1 ] [ 0 , 0 ] 

[17,377] [4,17] [0,15] 


2.1.4 Device Names in Radix-50 

The Radix-50 values for device names which appear on Monitor diagnos- 
tic message printouts are as follows: 


Device 


Radix-50 Value (Base 8) 


DF 

14760 

DK 

15270 

DC 

14570 

KB 

42420 

PR 

63320 

P.P 

63200 

LP 

46600 

DT 

16040 

MT 

52140 

CR 

12620 

PT 

63440 
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2.2 PAL HR ASSEMBLER V005A 



The symbol table capacity of PAL-11R V005A running under the Disk Op- 
erating System and utilizing overlays varies as a function of the I/O 
devices involved in the assembly. This is extremely relevant for 8K 
of core memory configurations. 


At assembly time, 5497 decimal words are always occupied by the 
following items: 


Resident PAL-11R 

3209 

Permanent Symbol Table 

336 

PAL-llR’s stack 

100* 

Absolute loader 

98 

Unnamed .CSECT entry 

4 

User Current Location " symbol 

4 

Resident DOS (RF11 Disk) 

1746** 


5497 


In addition to this figure, consider the non-resident requirements of 
DOS which consist of the buffers and drivers needed for the assembly 
and 256-^0 words for the .OPEN processor. 

The Assembler allows for: 

two input devices (files) 

three output devices (files) 

i . e. , binary 
listing 
symbol table 

and the command output device. 

The command output device and buffer is always required and occupies 
a total of 560 decimal words. 

5497 

+560 

6057 


*The Assembler will decrease its stack size in favor of symbol table 
entries. If the symbol table requirements are still too large, the 
assembly will be aborted with the F001 (STACK OVERFLOW) DOS error mes- 
sage. 

**If the system device is RK11, this figure increases by 144,- words. 
If the system device is RC11, this figure decreases by 7 words. 
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Periodically during every pass of the assembly, the .OPEN processor 
will be needed; thus, for symbol table purposes it can be considered 
as a permanent requirement. 

6J057 
+ 256 
6313 

The input file or files is required for the duration of an assembly. 

The medium chosen for input directly affects symbol table storage 
space , e.g. , 

Buffer Size per File Driver Size 

RF11 or RC11 Disk 96 decimal words system device included 

in resident DOS 

RKll Disk 288 decimal words 

DECtape 288 decimal words 165 decimal words 

The user saves 357 decimal words if his input file resides on the RK 
or RC disk rather than on DECtape. Thus, PIPing the sources from DEC- 
tape to disk prior to assembly increases symbol table storage by 89 
entries (4 words per symbol) . 

The output files are only required during their respective assembly 
passes; that is, 

symbol table - end of pass 1 

listing - pass 2 

binary - pass 2 

Choice of output medium has the same benefits here and, additionally, 
the user can "string out" the non-resident needs by specifying via 
the PASS command string option that the listing be output during pass 

3. 


Three examples, one worst case and the other two considerably 
better, will illustrate the above-mentioned facts ; 

EXAMPLE #1 (.Worst case) ; 


# DTI : TEST . OBJ , DT2 : TES T . LS T , DT 2 : TEST . SYM< DT3 : TEST . PAL 


1 t 1 


1 

165+288 


1029+6313 = 7342 leaving room for 211 user symbols 

or . CSECT names in 8K of core. 

*The binary file in pass 2 would use the same space required by the 
symbol table file at the end of pass 1. 
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EXAMPLE #2: 


Note that when a d e vic e is not specified in the command str ing, 
the system device is taken as the default. Assuming the system device 
is RF or RC disk: 


#TEST . OBJ , TEST . LST , TEST . SYM<TEST . PAL 

’t 

96 


!T . LST , TEST . SYMsTEST . ] 

t 1 t 

96 96 96 


288+6313 = 6601 leaving room for 397 user symbols or 

. CSECT names in 8K of core. 


The listing and symbol table files can later be PIPed from disk to a 
hard copy device such as the line printer, teleprinter, paper tape 
punch, etc. 

EXAMPLE #3: 

#TEST. OBJ, TEST. LST/PASS :3 ,TES^. SYMkTEST. PAL 

'ft t. t 

96 96 96 96 

The PASS: 3 switch makes the binary and listing outputs occur during 
separate passes; thus, they share output buffers and effectively in- 
crease symbol table capacity by 96 words or 24 symbols. The total 
capacity is now 421 symbols. 

The user should always be aware of his symbol table needs rela- 
tive to what his hardware configuration can provide. If he does 
this, he can segment programs that will exceed the limits, assemble 
them separately, and link the object modules with Link-11. 

2. 2. 1.1 Running the Overlay Builder (PALQB.LDA ) — The overlay builder 
creates the file of overlays via logical data set name OVR which has 
the default file specifier: 

sysdev: PALI 1R. OVR [LOGIN UIC]<233> 

It is recommended that the creation of the file of overlays be accomp- 
lished either while 

1. logged in under [1,1] 

*The binary file in pass 2 would use the same space required by the 
symbol table file at the end of pass 1. A UIC specification is required 
if PALOB.LDA is under a UIC other than the LOGIN UIC. 
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or 


2. with the Monitor ASSIGN command overriding the LOGIN 
UIC, e.g. : 

_;_AS sysdev :PAL11R. OVR [1 , 1] ,OVR 


In either of the above environments, the overlay builder can be exe- 
cuted , e . g . : 


^RUN sys dev : PALOB . LDA* 


and will create the 
with a UIC of [1,1] 
cated by the output 


file of overlays, PAL11R.0VR, on the system disk 
and then will exit to the Monitor which is indi- 
of the "$" . 


Transfer the Assembler from DECtape to the Monitor disk area with 

PIP. 


$PAL [1,1 ] <DT0 : PAL 11 R. LDA** 

2. 2. 1.2 Running the Assembler — The Assembler can now be executed 
via the Monitor command RUN: 


. RUN PAL 


it will search for its overlays first under the file specifier 
sys dev : PALllR. OVR [LOGIN UIC] 


and, if not found, then under 


sysdev: PALllR. OVR [1,1] 


A typical command to PAL-11R to assemble the source of PALSYM 
that exists on DECtape with the file name PALSYM. PAL would be: 


# PALSYM. OB J,LP: , 


LP :<DTJ0: PALSYM 

▲ 4 


object listing Symbol Table Source 
module to Line to Line from 

output Printer Printer DT0 


*A UIC specification is required if PALOB. LDA is under a UIC other 
than the LOGIN UIC. 


**A UIC specification will be required if PALllR. LDA is under a UIC 
other than the LOGIN UIC. 
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If the source was on paper tape, the command would read: 
#P ALS YM. OBJ , LP : , LP : <P R > 



paper tape 
reader 

The Monitor informs the user when to load the reader with the tape by 
typing 

A002 63320 

$ 

on the command output cbvice . A002 denotes device not ready; 63320 

is PR (paper tape reader) in Radix-50 notation. 

When the tape is ready, the user types the Monitor command 
continue. 

The end of an assembly pass is indicated by END being printed on 
the command output device. 

The end of an assembly is indicated by "#" (the command string 
request character) being printed on the command output device 

2. 2. 1.3 Overlays on DECtape 

Note that DECtape can be utilized as the overlay device. All that is 
required to accomplish this is : 

1. Make the desired file specifier change prior to running 
PALOB . LDA 

j_AS DT0 : PALllR. OVR [1 , 1] ,OVR 
j_RUN DT0: PALOB. LDA 

2. Make the same file specifier chance prior to running 
PAL 

^AS DT0:PAL11R.OVR[1 , 1] ,OVR 
_;_RUN PAL 

2.2.2 Cautions 

1. If no extension is specified for an input file, the As- 
sembler will first search for a file using the default 
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extension "PAL". If this file is not present, the 
Assembler will then search for a file with a null 
extension. Both files being absent would result in 
a fatal Monitor error. 

2. Macros for the DOS EMT's are not implemented. The 
user must type the expanded form. 

3. @A(R0) 

2A(R0) + 

3 A- (R0) 

are all accepted by the Assembler as valid represent- 
ations of the indexed deferred addressing mode @A(R0) . 
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2.3 EDIT-11 TEXT EDITOR Vj302A 


1. Use of PT: and KB: -- When using KB: for input, com- 
mands to Edit-11 which read text into the buffer re- 
quire that the user manually supply the end-of-page or 
end-of-data flags. The procedure is as follows: 

( J denotes the RETURN key) : 


a. To end a Read command from KB: the user 
should type CTRL/C followed by 

END 

followed by the RETURN and LINE FEED keys 
in that order. 

b. To end an EXit command from KB: the user 
should type CTRL/C followed by 

END 

followed by the RETURN and LINE FEED keys in 
that order. 

c. When using PT: for input, the procedure is: 

(1) . Put paper tape in reader and move 

switch to START. 

(2) Start Edit-11 and type command string. 

(3) Edit-11 will open the primary output 
file, read a few characters, then print 
an * to signal its readiness for a 
command. 

(4) Leave the reader on. Edit-11 will read 
tape when commanded to do so. 

(5) When the end-of-tape is reached during 

a read operation, signal so by typing CTRL/C 
followed by 

END PT 

followed by the RETURN and LINE FEED keys 
in that order. 


(3) When Edit-11 finishes punching leader, 
it pauses and waits for the punch to 
be turned off. When you have done so, 
pressing the LINE FEED key will resume 
Edit-11 operation. 

(4) From this point on, Edit-11 will pause 
before and after every output command 
to allow you to turn the punch on and 
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off. Pressing the LINE FEED key will 
cause it to continue. 

d. When using PT : for output, the procedure is: 

(1) With punch off, start Edit-11 and type 
command string. 

(2) When Edit-11 opens the punch for output, 
it will begin outputting nulls to the 
teleprinter. Turn on the punch. 

2. Monitor A Errors — If at any time during the editing pro- 
cess, or during the initialization, an A002 error is re- 
ceived from the Monitor, the user is required to take ac- 
tion to ready a device. Common causes are specifying PR: 
when there is no tape in the reader or specifying the wrong 
DECtape drive. Correct the problem, then type: 

CO 

followed by the RETURN key. Edit-11 will continue. 

3. PT: Versus DF: — If the tser plans to do a lot of paper 
tape editing, he can often save a lot of time by using 
the disk to store edited versions of files. Edit from 
PT : to DF: then do editing from disk to disk. When 
satisfied, PIP the good file back to paper tape. 

4. Use of Subsidiary Output -- As mentioned in the Edit-11 
manual, use of a fast output device such as LP : for list- 
ing text via the EW command will greatly increase edit- 
ing turn-around time. Use the L command sparingly and 
the printer often. 

2.3.2 Cautions 

1. If Edit-11 encounters an invalid Open because of a file 
already existing, it does not recover. Rather, an FJ312 
Monitor error will be printed on the teleprinter, and 

it is necessary to restart the Editor with CTRL/C and BEgin. 

2. The F and T commands presently provide for outputting 
only in the primary output device. To provide a Form 
Feed on the secondary output file, the Form Feed char- 
acter must be inserted into the page buffer by the 
user. There is also presently no means of punching 
trailer on the secondary output device. 
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2.4 OPT— HR DEBUGGING PROGRAM V002A 


A problem exists in version V002A and previous versions with regard to 
the saving of breakpoints at ODT ' s three entry points (OD K; OD R; OD) . 
There are two substantially different ways that ODT can be entered: 

1. ODT was used to set breakpoints in a program and the 
program crashed when it was given control by ODT. In 
this case, the Monitor will have control and the user 
will have typed: 

OD K 

or the user will have manually restarted ODT.* 

2. Any other entry to ODT (via Monitor commands such as 
RV, BE, OD; or because a breakpoint occurred) . 

V002A does not distinguish between these cases. Consequently, when 
ODT saves breakpoints and lestores user instructions to their previous 
values, it will restore memory correctly in case 1 , but will move 
an octal 00003 into locations on which breakpoints have been set in 
case 2. This will be fixed in a subsequent release of ODT. 


Until then, avoid exiting from ODT to the Monitor with break- 
points set in the program if ODT is to be re-entered. For example: 
when patching and saving prior to debugging: 

$GE prog 
$0D 

0DT11R V002A 

* (make patches here) 


$SA 
£0D K 

BEnnnnnn 

* 


$;B 

*c 

$SA 
$0D K 
BEnnnnnn 


(reenter ODT, preserve re- 
location registers) 

(Set breakpoints here) 

(Debug - if crash occurs, 
exit OD K) 

(make additional patches) 

(clear breakpoints) 

(save includes ODT) 

(reenter OUT) 

(continue using ODT) 


*ODT 1 s three starting addresses are at ODT's base +172g(OD), 174g(OD R) 
and 176g (OD K) . 



2 . 5 PIP FILE UTILITY PACKAGE , Vff?4A 


2.5.1 Programming Notes 

1. The /CO feature has a number of restrictions which will 
be fixed in the next version. Use of the asterisk 
feature with the /CO switch in a merge operation only 
obtains the first of the asterisk specified files. No 
error message is given. 

2. There is space for only 15 different UIC's on the RF11 
disk system. 

2.5.2 Cautions 


1. To transfer ASCII cards from the card reader to disk or 
DECtape, the /FA switch must be used. 

2. If the user attempts to transfer a series of files (such 
as with the * command) in which one has a protection code 
that does not allow transfer, a fatal Monitor error will 
result and successive files designated for transfer in 
that command string will not be transferred. 

3. CTRL/C RE does not yet work. Use CTRL/C BE. 

4. If a file appears on disk or DECtape with a name not 
acceptable to the CSI, it must be deleted using the * 
feature. For example: 

ABC. A (2 spaces in extension) 
is not acceptable and should be deleted. 

ABC. */DE 

The above works unless the file is locked; in which case 
it must be deleted using SYSLOD, as the * feature has not 
yet been implemented for UNLOCK- 

5. The * feature is not implemented for the RENAME and 
UNLOCK switches. 

6. When transferring files, the * cannot be specified in 
the output field of the command string; it will create 
a file with the extension (space) AB, and no error 
message is given. 
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To copy files from one device to another using 
the *, the * must be in the input field of the com- 


devl :<dev2 : *. * 


or 


devl :<dev2 : *.PAL 
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2.6. LINK-11 LINKER V005A 


2.6.1 Programing Notes 

The whole Linker resides in core while it is linking. Neither the in- 
put files nor the output file are ever "in core" in their entirety . 

In pass one, the Linker reads the input files one buffer at a time 
and extracts the global symbols from them. These symbols are kept in 
core in the global symbol table for the whole duration of the linking 
and relocating process. In pass two, the input files are read again, 
one buffer at a time. (The output file will need to be loaded into core 
subsequently by a system loader.) 

The memory map as shown below represents core while Link-11 is 
in control : 


Last Location of Core 


First Location of Core 


To utilize all possible core space for additional symbol table space, 
use the delivered load module of Link-11 (LINK11.LDA) to relocate the 
object module of Link-11 (LINK11.0BJ) as high in core as possible. 

1. If a top or bottom was specified once, then at each 
successive linking-relocating task if a top or bot- 
tom is not specified, the one formerly specified 
will still be in effect ( and not the default assump- 
tion ) . 

2. No switch can appear alone by itself in an input 
specification (i.e., ,/U, and ,/E are illegal; 

,dev: f ilname . ext/U , and def : f ilname. ext/E are 
legal) . 

3. There are several ways to link 0DT11R. 

a. dev :outf il . ext ,mapdev: <dev: test ,dev :0DT11R.0BJ/0D/E 
(The OD switch is set) 

allows the Monitor command BE to start the test 


ABSOLUTE LOADER 


LINK-11 


GLOBAL 

SYMBOL 

TABLE 


DOS 
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program, OD to start ODT (assuming in all cases 
that the Monitor command GET OUTFIL.EXT precedes) . 

b. devroutfil. ext,mapdev:<dev :ODTllR.QBJ.dev: tes t/E 
(no OD switch) 

allows BE to begin ODT. OD will have no effect. 

c. devroutf il. ext ,mapdev: <dev:ODTl 1R. OBJ/E 

allows ODT to be rim by itself with the BE command. 


4. When using the /OD switch: 


default device 
default file name 
default extension 
secondary UIC 


as usual, disk 
ODT 

as usual , OBJ 
1,1 


If ODT. OBJ is on either the system or user disk 
area, the input file specification for ODT in the 
CSI reduces to: 


/OD 

For example : 

<DTl :PROG,/OD 

when the device for ODT is DTI. /OD, cannot be the first 
input file specification. However, the following is valid: 

sysdev: ODT [1, 1] /OD, 


5. a. When creating object modules by PAL-llR or 

when transferring object modules by PIP, al- 
ways specify in the output file specification 
a file extension in order to be able to link 
it with Link-11, which assumes extension .OBJ 
when none is specified. 

b. Always specify a file extension for the output 
file of Link-11; specify the same file exten- 
sion when issuing the Monitor commands RUN or 
GET. 

6. If a WRITE error occurs, the dev : f ilnam. ext part 
of the error message is not printed. 

7. The Linker will not Jink libraries from paper tape. 

8. The /OD and /TR switches are mutually exclusive. 

9. If the user has a library which contains backward ref- 
erences, put the library file into the command 
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string to the Linker repeatedly until all ref> 
erences are satisfied. For example, given the 
four object modules: 

PA, PB, PC, PD 

Object Module PA : 

.TITLE PA 
. GLOBL B 
.END 

Object Module PB : 

.TITLE PB 
.GLOBL B,C 
B : 1 
.END 

Object Module PC : 

.TITLE PC 
.GLOBL C 
C : 1 
.END 

Object Module PD : 

.TITLE PD 
.END 

where PA references PB,and PB references PC. 

If we create three files FI. OBJ, F2.0BJ, and 
F3.0BJ where: 

(a) file FI. OBJ contains object module PA, 

(b) file F2.0BJ contains a library in which 
PB is first and PC is second, and 

(c) file F3.0BJ contains object module PD 

then the four programs can be linked with the 
following command strings: 

#OUT ,MAP<F1 , F2/L/U 

There were no undefined references left, so con- 
clude the linking process by typing the command 
string : 

JF3/E 

If file F2.0BJ contains a library in which object 
module PC is first and PB is second, then after the 
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command string: 


#OUT,MAP F1/F2/L/U 

the following message will be printed: 

UNDEFINED REFERENCES 
B 

Now issue the second command string : 

J-F2/L/U/ 

There will be no more undefined references left 
this time, so the linking process can be concluded 
by typing the third (final) command string: 

#F3/E 

The four linking modes are shown in Table 2-2. 


TABLE 2-2 


LINK MODES 



Function 

Performed by 

Linker 

Format 

Generate 

Load Module 

Generate 

Load Map 

Report 

Errors 

output ,<map inputs 

yes 

yes 

yes 

output<inputs 

yes 

no 

yes 

,map<inputs 

no 

yes 

yes 

<inputs 

no 

no 

yes 


2.6.2 Cautions 

If the user means to type: 

PP : ,LP:<PR:/E 
but accidentally types: 

PP : ,LP<PR:/E 

the load map (an ASCII file) will be punched on the paper tape before 
the load module (a binary file). The Linker will not detect the error 
since the erroneous string is a legal one , thus the load module cannot 
be loaded (since there is an ASCII file in front of it) . 

There is a fair amount of blank tape between the load map 
and the load module, so either separate them or relink the task. 
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Files will be linked to the top of available core unless the Top 
C/T) or Bottom (/B) switch is used to specify a different area in core. 
PIP, however, must not be linked higher than the top of 16K. Therefore, 
with systems of 20K or more, the Top switch must be specified in the 
command string, i.e., /T:77j30J0. 

LINK-11 will malfunction vhen a blank field appears for the map 
specification. For example: 

#LOAD . MOD ,< OBJ . MO D/E 

The lack of an output device specification causes DOS to print an ap- 
ropriate message and halt. 

The following command strings will be serviced properly: 

_#L0 AD . MOD<OB J . MOD/E 
#LOAD . MOD , LP :<OBJ . MOD/E 

In the first case no map is required; in the second case the 
line printer is specified as the map printing device. 

2.7 LIB R- 11 LIBRARIAN V002A 


2.7.1 Programming Notes 

1. Creating a library requires an output library speci- 
fication and the input files to be placed in the 
library. The input files must be preceded by a 

comma, so they are not considered to be input libraries. 
Listing the newly created library is optional. 

2. To update a library, both output and input library 
specifications are required, along with object 
modules or input files. Updating includes dele- 
tion of object modules, insertion of object modules, 
and replacing of one or more object modules. Listing 
the updated library is optional. 

3. To list the contents of a library only requires a 
listing file specification and an input library 
specification. The listing file specification must 
be preceded by a comma, so that it is not interpreted 
as an output library. 
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CHAPTER 3 


MONITOR DECT APE SETUP AND UPDATE PROGRAM 


3.1 INTRODUCTION 

The Monitor within the PDP-11 Disk Operating System (.DOS) is basically 
a series of individual program modules, each of which can satisfy 
some requirement of a user program or of an operator request from 
the console keyboard. The appropriate module is normally brought 
into the computer memory only when needed. Otherwise, it resides 
within a library (MONLIB) on the system disk and for speed of loading 
it must be stored as a core image. 

It is the function of the System Loader (SYSLOD) , generally, to 
prepare the system disk for DOS usage and, in particular, to 
establish MONLIB in the required form. It accomplishes the latter by 
converting the Monitor modules from the load format produced by 
PAL-11R Assembler and Link-11 Linker processes. If the modules are 
linked to paper tape, they can be fed directly to SYSLOD in a speci- 
fied order via the PC11 Reader. SYSLOD, however, is also prepared 
to accept as input a DECtape file, MONLIB. SYS, which contains the 
load-format modules already strung together in the required sequence. 

The Monitor DECtape Setup and Update Program (MODS) provides a 
means whereby the user can prepare this DECtape file and later main- 
tain it, should existing modules need to be replaced or new ones be 
added. Moreover, the ROM Bootstrap, stipulated as a basic element of 
any DOS-supplied configuration to enable automatic Monitor startup 
from disk, can also be used with DECtape. MODS, therefore, stores 
SYSLOD itself on the same tape as MONLIB. SYS as a core image readily 
accessible by the Bootstrap. The basic format of the tape thus 
produced uses facilities outside those provided by the standard file 
structure operations of DOS. It cannot, as a result, be copied by 
the usual means, PIP-11 (although once prepared it can thereafter be 
used to store other files in the normal way) . Instead, MODS can be 
used to copy the basic system tape content to another tape. 

3.1.1 Operating Configuration 

The MODS program is designed to operate under DOS. It can be run on 
any configuration which will support DOS, provided that DECtape is 
included. For ease of operation, however, a PCll Reader is also 
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recommended. The ASR-33 Teletype as the sole means of paper tape 
input is time-consuming and imposes other restrictions which will be 
discussed later. 

3.1.2 Outline of This chapter 

This Chapter is intended to show how MODS may be used. Section 3.2 
gives a general description of the program and Section 3.3 details 
its operating instructions. 

It is assumed that the user is already familiar with the general 
principles of DOS as described in the Programmer's Handbook 
(DEC-ll-MWDA-D) . 

3.2 GENERAL DESCRIPTION 


3.2.1 Command Input 

A command string entered through the console keyboard directs the MODS 
program to operate in one of two modes and at the same time indicates 
the relevant devices to be used. 

a. Setup — A new DECtape is prepared to contain SYSLOD and 

MONLIB . SYS by transferring both from the same 
source, either DECtape or paper tape(s); or by 
copying MONLIB. SYS from another DECtape and 
inserting a new SYSLOD from paper tape. 

b. Update — The new DECtape is a copy of SYSLOD from another 

DECtape and MONLIB. SYS is also a copy but, in 
this case, possibly modified by new module 
versions entered from paper tape. 

The command strings to accomplish this are shown in detail in 
section 3.3. In general, since MODS uses the DOS Monitor Command 
String Interpreter (CSI) to analyze the user's input, they follow the 
format prescribed for that routine. 

MODS checks the validity of the user's specification and, if any 
error is encountered, an appropriate message is printed at the con- 
sole teleprinter and the user is requested to enter a new string. 

MODS also confirms, where SYSLOD is to be copied from another DECtape, 
that it is, in fact, available on that tape. If not, a Monitor fatal 
error message results and the user must begin MODS anew. 
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3.2.2 Basic Preparation 

The first step in the preparation of the new DECtape for either mode 
of operation is to establish a basic file-structure upon it. Basically 
this requires the writing of appropriate information in Blocks 100-101 
(Master File Directory) , Blocks 102-103 (User File Directory) , and 
Block 104 (Master Bit Map) . In addition. Blocks 70-77 are cleared 
in readiness for later usage as storage for individual File Bit Maps. 

While providing this basic layout, MODS also reserves two con- 
tiguous areas on the new tape and enters appropriate identifying file 
information in the UFD: 

a. Blocks 0-37 will be used to store the core image of 

SYSLOD (covering memory locations 0-36776) 
and its Loader called by the ROM Bootstrap. 

b. Blocks 320-1077 

are set up as a dummy file to force the 
allocation of blocks to MONLIB.SYS to be 
at the forward end of the tape only. 

At the same time, MODS initiates the filling of its internal buffers 
with any data to be entered from paper tape. 

3.2.3 Transfer of SYSLOD 

In either mode, SYSLOD can be copied from another DECtape by merely 
transferring Blocks 0-37 from that tape to the new tape. This is 
speedily done by moving alternate sets of four blocks in two tape 
travel directions. 

The paper tape SYSLOD is in the load format output by the Link-11 
Linker. It must be preceded by a special resident version of DOS 
Monitor in similar load format. (The DEC Program Library supplies 
both routines on the same tape.) This format must be appropriately 
converted into the core image required. Moreover, in order that this 
image can be accessible via the ROM Bootstrap, an appropriate loader 
must be provided. 

Therefore, MODS first moves into Block 0 the required loader from 
a copy stored within itself. It then checks that the paper tape being 
entered does, indeed, contain the special Monitor version and, if so 
converts the input into its core image starting at Block 1 on the tape 
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and continuing across contiguous blocks, two at a time. When the end 
of this routine is encountered, MODS expects the entry of SYSLOD itself 
and checks for this. If satisfied, the similar core image on the tape 
is prepared with blocks corresponding to any unused intervening core 
space first being cleared. MODS also establishes an appropriate link 
between the two routines within the image. 

During this entire transfer process, errors arising either be- 
cause the tapes entered are not those expected or are not in the 
correct format or through general read failure are reported to the 
user by an appropriate message at the printer and a new start must be 
made . 


3.2.4 MONLIB . SYS Entry (Setup Mode ) 

When stored on the DECtape, MONLIB. SYS is a normal linked file within 
the DOS file-structure scheme. To copy from one DECtape to another 
is a relatively straightforward operation, provided that the input 
tape specified by the user does, in fact, contain the requisite copy. 
Because of the dummy file mentioned in section 3.2.2, the second half 
of the transfer between the two tapes will occur with the new tape 
moving in the reverse direction, finishing approximately back at the 
Directory blocks. 

When MONLIB. SYS is merely a string of the Monitor modules in 
linker format, copying from paper tape is a simple process. In this 
case, however, the user must ensure that the first module entered is 
a copy of the normally permanent resident Monitor and the second 
module is the transient Monitor section TMON linked with a copy of 
the READ-WRITE processor. The remaining modules may follow in any 
order. (Tapes supplied by DEC Program Library are numbered to 
provide the requisite sequence.) 

3.2.5 MONLIB. SYS Entry (Update Mode) 

The user may be completely unaware of the sequence in which MONLIB. SYS 
was originally set up on this input DECtape. To allow him to enter 
his new modules from paper tape in any order, the Update mode of MODS 
first stores all of them as a series of temporary files on the system 
disk and maintains its own in-core directory of these for easy access 
later. 
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The following points concerning this process should be noted: 


a. MODS uses the loader format to differentiate between modules. 
Therefore, there is no need for the user to enter them 
individually; if required, they can all be strung together 
on the same physical paper tape. 

b. Should an error occur at this stage, some of these disk 
files could remain and might then cause file-structure 
errors if MODS is asked to start over. To prevent this, 

MODS first deletes any file on the disk using a name it is 
about to enter. Users should, therefore, avoid setting 

up their own files using names allocated to Monitor routines 
as given in the programming manual with a .TMP extension. 

c. It follows from b. that if the user enters more than one 
copy of the same module, the last one seen will always be 
the one included in the final version of MONLIB.SYS on 
the new DEC tape. 

After all the paper tape modules have been handled in this 
fashion, MODS begins its transfer to the new DECtape. As the start 
of each module is encountered on the input tape, the in-core directory 
is searched for a corresponding new version. If none has been 
supplied, the original is merely copied across. Otherwise, the 
original is skipped and the new version is used to replace it. The 
disk file is then immediately deleted, but its in-core reference is 
retained. Because the skip of the original precedes its replacement 
from disk and MODS ignores the latter if the required file is no 
longer present, the immediate deletion has the effect of removing any 
other copy of the same module which might occur later within the 
original DECtape file. Thus the new MONLIB.SYS file may be not only 
an updated version but also a tidier one. 

Finally, at the end of the original DECtape input, MODS makes a 
last search of its in-core directory and adds any completely new 
modules to the output file. 
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3.2.6 General Cleanup 

After closing the new file, MODS requests deletion of the dummy file 
at the end of the tape and reinitializes itself for a further run. 

The new tape itself can be used later to store other system programs 
using PIP. 

3.2.7 General Comment on Paper Tape Usage 

The MODS program has been designed to allow the use of either PC11 
Reader, if available, or the paper tape reader of ASR-33 Teletype, in 
that transfers are carried out using .TRAN requests to the Monitor 
rather than the more customary .READ. This follows from the fact 
that the ASR-33 is classified as an ASCII-only device and cannot be 
used to read the binary data of a Linker output module. 

However, another problem still exists. All input from the ASR-33 
is monitored for the start of a keyboard command from the operator, 
as indicated by the entry of CTRL/C. Because the computer cannot 
distinguish between a character coming from the keyboard and one 
coming from the paper tape reader, recognition of the appropriate 
ASCII code (3 or 203) within the binary data is treated in this way. 

As a result, MODS cannot allow operator intervention if its paper tape 
input comes from the ASR-33. 

3.3 OPERATING INSTRUCTIONS 

3.3.1 Loading MODS 

The new DECtape to be prepared by MODS must be set up under the 
standard System Identification Code 1,1. The user should, therefore, 
ensure that he has logged in under this. He may then request MODS 
loading by a normal RUN command at the keyboard. When entered, MODS 
identifies itself and prints # in readiness for the input of its 
command string. Assuming MODS has been stored on the disk, the result- 
ing teleprinter record might be (user input underlined) : 

MONITOR V002A 
$ LO 1 , 1 
DA: dd-mmm-yy 
TI : hh:mm:ss 
SRU MODS 

MODS- 11 V003A 

# 
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3.3.2 Command Input 


string now entered by the user can be one of several forms, depending 
upon requirements. Examples are given below: 


a. 


b . 


1 . 

1 1 

1 1 

2. 

{...} 

3. 

n 

4. 

Ta :n 

Set 

up a : 

the 

same i 


£DTn:< 

Set 

up a : 

and 

SYSLO 

iDTn : < 


NOTE 

Items enclosed in square brackets can be 
omitted from the string, in which case 
DTpf : will be the default assumption. 

Items enclosed in braces show possible 
alternatives, one of which must be present. 

represents the DECtape unit number. 

indicates the decimal number (n) of physical 
paper tapes to be entered via PC11 Reader 
and must be supplied. 


fDTn 

Hpr 

[PT 


n: 3 

: /TA : n ± 


lDTn:<J DTn: ,|p^* /TA:n | 


c. Update MQNLIB.SYS from another DECtape, new modules being 
entered from paper tape : 


[DTn : ]/U<DTn 


fPR:/TA:n\ 
: '\PT: J 


Upon completion of the requested operation, MODS prints #. 

3.3.3 Error Reporting 

Errors in the input string or through read failure in the subsequent 
transfer operations are diagnosed by plain language messages. In all 
cases, MODS returns to request a completely new input string by 
pointing # following the message. 


File structure errors due to the nonexistence of SYSLOD or 
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MONLIB . SYS on a specified input DECtape result in a fatal diagnostic 
message from the DOS Monitor. The user may then request a restart 
by either a Begin or a REstart command. 

3*3.4 Operator Action During Processing 

Apart from the special treatment required if PT: forms part of the 
input specified (see section 3.3.5), the only operator actions likely 
to arise during processing are as follows: 

a. A specified DECtape is not ready — the DECtape driver 

initiates the printing of an A002 16040 message if the 

correct units are not made available or the output unit 
is write-locked. The program is resumed if the omission 
is rectified and CO^ is entered as a keyboard command. 

b. At the end of each physical paper tape being entered via 
the PCll Reader (until the count given in the input string 
runs out), MODS prints an A002 63320 message. The next 
tape should be placed in the reader and CQ} be entered. 

NOTE 

MODS expects the first paper tape to be already 
set up in the reader when the command input string 
is issued. If not, the nonexistent tape at this 
point counts as one of the entries. 

3.3.5 Special Action for PT: Usage 

As noted in the General Description under Section 3.2.7, usage of 
PT : poses a special problem. For this version of MODS (V003A) this 
can only be solved by the user making the following modifications to 
the resident Monitor before entering the input command string: 


#+c 

AiA 


; SUSPEND PROGRAM & ENTER MONITOR 
; LISTENING MODE 

$ MO 3374 


; CHANGE MONITOR AS REQUIRED 

3374/1011 

411 

; USER TYPED 411 

$ MO 3424 
3424/1767 

412 

; USER TYPED 412 

£CO 


; RESTART MODS OPERATION 


;NOW ENTER COMMAND STRING 
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After typing in the command string as required, the paper tapes 
can be fed through the ASR-33 reader one by one (with the reader 
turned on). No computer pauses occur between tapes. Also, the user 
should avoid striking the keyboard during this period, as all input 
is now deemed to originate from the reader. It is also advisable 
that the user take extra precautions to avoid error action necessi- 
tated by failure to set up the DECtapes correctly. 

When all paper tapes have been input, the user should halt the 
computer and manually restore the locations changed above. He 
should then press CONTinue and enter the following command at the 
keyboard in order to proceed: 

#tc . 

TEN PT:J» 

followed by the HERE IS key on ASR33 or BREAK key on ASR35 . 

NOTE 

Tapes should be removed from the reader while 
blank trailer tape is still being read. 
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CHAPTER 4 


DOS SOFTWARE MANUAL UPDATE 


This chapter contains errata/addenda sheets for updating 
your PDP-11 Disk Operating System software manuals. Errata 
sheets should be used in making pen-and-ink corrections to the 
appropriate manuals; replacement pages should be placed in the 
appropriate manuals as updated pages . 

Listed below are the current PDP-11 DOS software manuals. 
Also given are the document number and status of each manual, 
the date of the current update sheet (s), and the version number 
of the program which the updated manual describes. 


Title & Doc. No. 

Status 1 

Update 2 

Program 

Version 

Disk Operating System Monitor 
Programmer 1 s Handbook 

DEC- 11-MWDB-D 

3 


V004A 

FORTRAN Programmer 1 s Manual 
DEC-ll-KFDA-D 



V001A 

PAL-11R Assembler 

Programmer's Manual 
DEC-ll-ASDB-D 

1 

July '71 

V005A 

Edit-11 Text Editor 

Programmer's Manual 
DEC-ll-EEDA-D 



V002A 

0DT-11R Debugging Program 
Programmer's Manual 
DEC-11-00DA-D 



V002A 

PIP File Utility Package 
Programmer ' s Manual 
DEC-ll-PIDA-D 

1 

July '71 

V004A 

Link-11 Linker & Libr-11 
Librarian 

Programmer ' s Manual 

1 

July '71 

V005A 

& 

V002A 


DEC— 11-ZLDA-D 


1 Status: 1 = Errata/ addenda attached 

2 = Revised edition in process 

3 = New edition (contains previous updates) 

2 

Date of applicable updates 

NOTEi Additions to previous update sheets and replacement 
pages made at this time are indicated by a bar in 
the left margin of the current sheets. 
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Page 

viii 

8- 9 

9- 1 

10 - 1 

A— 3 

B-4 

B-5 

B-6 

B-8 

B-9 

B— 10 

C— 1 


PAL-11R Assembler, Programmer's Manual 
DEC— 11— ASDB— D 


July, 1971 


ADD: Appendix D Permanent Symbol Table 

Appendix E System Error Messages 

Section 8.12, beneath first paragraph. CHANGE: 


. IFZ 

to: 

.IFZ 

or 

. IFEQ 

. IFNZ 

to : 

.IFNZ 

or 

. IFNE 

. IFL 

to : 

.IFL 

or 

. IFLT 

. IFLE 





. IFG 

to : 

.IFG 

or 

. IFGT 


Section 9.2, third line, CHANGE: 

PALllR V002A to: PALllR V005A 

Error Code L, CHANGE TO: 

Line buffer overflow, i.e., input line is greater 
than 83 characters. Extra characters on a ... 

Octal Codes 136 and 137, ADD in REMARKS columns: 

136 (prints as a circumflex on some devices) 

137 (prints as an underline on some devices) 

Under sections B.3.1, B.3.2, B.3.3, B.3.4 and 
B.3.7, remove the parentheses from around the 
element to which an arrow points. For example 

(SE)+DE 

but (SE)-(DE) 

CHANGE mnemonics as indicated below: 


.IFZ 

or 

.IFEQ 

.IFNZ 

or 

.IFNE 

.IFL 

or 

.IFLT 

.IFG 

or 

.IFGT 

Code 

L, 

CHANGE 


Line buffer overflow, i.e., input line exceeds 
83 characters. All characters beyond 72 are 
ignored. 

Line 18, CHANGE TO: 

the Monitor command RUN while logged in under 
UIC 1,1. It will produce... 

Line 19, CHANGE TO: 

PALllR. OVR, on the system device 1 with User... 
Line 25, CHANGE TO: 

Presence of... on the system device 1 
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06 


DEI£TE entire page by defacing. 


07 

through REMOVE FROM MANUAL 
012 

Appendix D dated July 1971. INSERT INTO MANUAL. 
Appendix E dated July 1971. INSERT INTO MANUAL. 
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APPENDIX D 


PERMANENT SYMBOL TABLE 


A listing of the Permanent Symbol Table follows* 


.TITLE PAlSYM 

THE PERMANENT SYMBOL TABLE (PST) 

VERSION LEVEL -2 

patch level a 

COPYRIGHT 1971, DIGITAL EQUIPMENT CORP. 
MAYNARO, MASSACHUSETTS 

ITHE PST IS A SEPIRATI OBJECT MOQULE WHICH 
IIS LOADED TO RESIDE IMMEDIATELY BELOw THE 
I ASSEMBLER in core MEMORY, ONCE assembled# it 
IIS FIXEO IN SlZEl HOWEVER, It MAy BE 
lEDJTEO, assembled, ano LINKED to suit the 
I SPEC I PIC NEEDS OP CU8T0HERS. 

ITHE PST IS BOUNDED BY THE INTERNAL GLOBAL 

isymbols symtbb and symtbt, where the 
i former is the HIGHEST AODRESS of the 
I PST AND THE LATTeR IS THE ADDRESS OF 
ITHE 1ST WORD BELOW THE PST, 

ITHE PST IS ORDERED (TO PERMIT BINARY 
ISEaRCHINdI WITH THE SMALLEST SYMBOL (IN 
|M0D4(? PACKED NOTATION) HIGH IN CORE AND 
ITHE LARGEST SYMBOL (IN MOD40 PACKED NOTATION) 

I LOW IN CORE. 

JMQO40 CHARACTER REPRESENTATION 
IA THRU Z I 1 THRU 26 respectively 

I S I 27 

I , I 28 

1C! thru 9 4 30 THRU- 3S RESPECTIVELY 

I M004{? PACKED notation 

I I ST PACKED triad a CHAR 1 *40*40*CHAR2*40 + CHaR3 

1 2ND PACKED TRIAD ■ CHAR4*40*40*Ch AR5*40*CHAR6 
I 

I EACH entry IS 4 WORDS WITH ThE LOWEST WORD 
ICOnTaInInG The 1ST PACKED TRIAD# THE NEXT 
ILOwEST CONTAINING THE 2ND PACKED TRIAD, THE 
f NEXT LOWEST CONTAINING THE VALUE (WHICH FOR 
IASSEMBLER DIRECTIVES IS AN EXTERNAL GLOBAL 
I TO BE LINKEO- TO THE- -APPROPRIATE PROCESSOR IN . 
IPAL-UR) AnO THE HIGHEST WORD CONTAINING 
ITHf FLAGS IN THE LON -BYTE A NO THE CONTROL 
ISECTION 10 (WHICH IS ALWAYS 0 FOR PST 
IENTRICS) IN THE HIGH -BYTE, 

I 

i internal global symbols* 

•globl syhtbb, symtbt 
i 

iexternal global symbols! 

.GLOBL- ASCII# ASECT* byte# CSECT# ENO 
•GLOBL ENOC# EOT, EVEN, GLOBL# IFDF 
.GLOBL- IFG.-IFGE, XFt# IFLE# IFN0F 
.GLOBL XFNZ, IFZ, LIMIT# RAD50 
.GLOBL TITLE# WQRO 
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I 

I FLAGS I 
ASMDIR»10 


ByTFLG*! 


I SI T 3 BEING ON IN THE FLAG 
isyte indicates that this pst 
IENTRY IS AN ASSEMBLER DIRECTIVE. 
I BIT S BEING ON In THE FLAG 
IBYTE INDICATES THAT THIS PST 
IENTRY IS BYTE ENABLED. THIS 
I ALLOTS ONE ENTRY TO satisify 
I SEARCHES FOR HORD AND BYTE 
instructions, e,g, the entry 
I *HOV 1 t BECAUSE BIT B IS ON , 
f WILL SATISFY SEARCHES FOR 
H MOV OR iMOvgi 


I 

INSTRUCTION CLAS8I 

I BITS 4»7 OF THE FLAG BYTE DESIGNATE THE 
I TYPE OF INSTRUCTION TO PROVIOE DISPATCH 

INFORMATION TO PaL-IN, 


SCL A 80»0 
SCLA8 1*20 
SCLAS2 *40 
SCL AS3*60 
SCLAS4*100 
SCLAS5* 1 20 
SCLAS6* 1 40 
I 
I 
I 


IOPERATE group 
iunary group 

I BINARY GROUP 
IRTS 

I BRANCH GROUP 
I JSR 

ITRAP GROUP 


• EVEN 
SYMTBTI .WORD 

1 

• WORD 

0 

131247 

• WORD 

070440 - 


1 1 ST REGISTER BELOW PST, 
I .WORD 


.WORD WORD 
.WORD AftMOXR 


I 

.WORD 131094 | .TITLE - 

.WORD 077343 
■ WORD TITLE 
.WORD ASMDXR 


I 

.WORD 130721 
.WORD 017226 
•WORD RAO80 
.WORD A8M0IR 
I 

.WORD 130351 
.WORD 051274 
.WORD LNXT 
.WORD ASHDXR 
I 

.WORD 130156 
.WORD 121200 
•WORD XFZ 
.WORD A8H0XR 


I .RAD50 


I .LIMIT 


I .IFZ 
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F 


F .ifnz 


F 


I 


I 


F 


f 


i 


i 


f 


t 


i 


) 


f 


. wORO 

130156 

a m H_48 Qffl 

0 Wry K U 


.WORD 

XF&Z 

• WORD 

AS*0I* 

, R AO50 

/.IF/ 

,RA05» 

/nE/ 

• WORD 

IFNZ 

.WORD 

A5MDIR 

.WORD 

130156 

. w ORO 

054046 

.WORD 

IFN0F 

.WORD 

AS^DIR 

,RA05? 

/.IF/ 

.RAO50 

/IT/ 

.WORD 

ifl 

• WORD 

AS*OI« 

. wORD 

130156 

.WORD 

045710 

.WORD 

IFLE 

.wORD 

ASMDIF 

.WORD 

130156 

• WORD 

045400 

.WORD 

IFL 

.WORD 

AS*DIR 

,RAn5$ 

/.IF/ 

.RADbp 

/GT/ 

• WORD 

ifg 

• WORD 

asMOIR 

.WORD 

130156 

.WORD 

026210 

.WORD 

IfGE 

.WORD 

A3M0IR 

.WORD 

130156 

.WORD 

025700 

.WORD 

IFG 

.WORD 

as*oir 

.RAoSpi 

/.IF/ 

,RAo50 

/EQ/ 

.word 

IFZ 

.WORD 

ASMOIR 

,*ORO 

130156 

.WORD 

01 4760 

,wOPD 

IFOF 

.WORD 

asmqir 

.WORD 

130044 

.wO-RO 

357034 

.WORD 

GLOBL 

.WORD 

ASMOIR 

.WORD 

127736 


I .xfne 


I .IFnDF 


> .iflt 


I .IFLE 


f .xfl 


I ,XF5T 


F .XFGE 


F .XFg 


I .XFEQ 


I .XFdF 


F .GLOBL 


F .EVEN 
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WORD 

020560 

WORD 

Even 

WORD 

as*DXR 


I 


! 


I 


I 


I 


f 


I 


t 

t 

I 


t 


I 


.WORD 127727 » .EOT 

.WORD 076400 

.WORD EOT 

•WORD A$*OlR 

.WORD 127726 I ,ENDC 

.WORD 014070 

.WORD EnDC 

.WORD A0M01R 

.WORD 127726 I .END 

.WORD 014400 

.WORD EnO 

.WORD AS*DIR 

.WORD 127613 t .OSECT 

•WORD 017714 

.WORD CSECT 

.WORD *6*018 


WORD 

127561 

1 .byte 

WORD 

076710 


WORD 

ByT-E- 


WORD 

As*D!R 


WORD 

127473 

l .ASECT 

WORD 

0177-14 


WORD 

ASECT 


WORD 

ASMDXR 


WORD 

127473 

1 .ASCII 

WORD 

012061 


WORD 

ASCII 


wORD 

ASMOIR 



.WORD 

• WORD 

• WORD 
.WORD 

• WORD 
.WORD 

• WORD 
.WORD 

.WORD 
.WORD 
. WORD 
.WORD 


127761 

076400 

000001 

SCLA60 


077721 

062000 

104400 

6CUS6 


IWAIT 


I T3T 


I TRAP 


100014 

0 

005700 

SCUSlwBYTFLG 
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wQrD 

a? Si at 

1 SWAB 

WORD 

006200 


wO»Q 

000300 


wORD 

SCUSt 


WORD 

075012 

I SUB 

WORD 

0 


WORD 

160000 


WORD 

SCUS2 


wORO 

073642 

>SEZ 

WORD 

0 


WORD 

000264 


wORD 

SCUS0 


WORD 

073636 

rsEv 

WORD 

3 


WORD 

000262 


word 

SCL4S0 


WORD 

073626 

l SEM 

WORD 

0 


WORD 

aa0270 


WORD 

SCUS0 


WORD 

373613 

i SEC 

WORD 

0 


WORD 

030261 


WORD 

SCUS0 


WORD 

073473 

ISCC 

WORD 

0 


WORD 

000277 


WORD 

SCLAS0 


wQRD 

373423 

1 SBC 

WORD 

0 


wORD 

305600 


WORD 

SCLASl*BYTFtG 


WORD 

371663 

JRTS 

wORD 

0 


wORD 

000200 


WORD 

SCLAS3 


WORD 

071651 

7 RTI 

WORD 

0 


WORD 

000002 


WORD 

SCLAS0 
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I 


I 


9 


P 


I 


I 


9 


> 


t 


9 


• WORD 

epusa 

.WORD 

0 

• WORD 

••*1*9 — 

• WORD 

3CLAS1*BYTF16 

• WORD 

071344 

• WORD 

« ...... 

• WORD 

00*100 

• WORD 

SC44IUSVTIU- 

• WORD 

•7*933 

• WORD 

001140 

• WORO 

0000*9 

• word 

SCU90 

• WORO 

094790 

• WORD 

• -• 

• WORD 

000240 

• WORD 

SCI 4 9* . - 

• WORD 

•*4417 

• WORD 

0 

• WORD 

0*3400 

• WORD 

SCU4S1WBVTFL6 

.word 

091696 

• WORD 

• 

.WORD 

010000 

• WORD 

SCUaawBYTFC* - 

• WORD 

040612 

• WORO 

0 

• »QRO 

004000 

• WORD 

SCUS5 

• WORD 

040230 

• WORD 

0 

• WORD 

00*100 

• WORD 

SCL4S1 

• WORD 

033254 

• WORD 

0 

• WORD 

00*004 

.WORD 

SCUA90 

• WORD 

035163 

• WORD 

0 - 

• WORD 

005000 

• WORD 

SCUSUBYTf^O- 


#* 0* 


1*01 




pNOR 




|HOV 


IJSR 


PJH* 


HOT 


I INC 
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.WORD 

031064 

} wa^T 

.WORD 

07^400 


, wQRU 

0 


• wORD 

3CLAS0 


. wQRQ 

0?0534 

IEHT 

■ wORD 

0 


.WORD 

104000 


. wORD 

SCWAS6 


, wORO 

014713 

IOEC 

. wQRO 

0 


. w OR 0 

005300 


.WORD 

sclasi+bvtfus 


. wQRD 

0)2445 

icon 

. WORD 

0 


,wORD 

005100 


.WORD 

SCLASI+BVTFLG 


, wORO 

012412 

ICN7 

.WORD 

0 


. wORO 

000254 


,wORD 

SCI AS? 


s w 0 R D 

01233? 

ICMP 

.WORD 

0 


. wOR 3 

0?0000 


, wORD 

SCUAS2WB7TFLG 


. w C: k 0 

012272 

1 CLZ 

. * t i ft i ) 

0 


,wORD 

000244 


, wORO 

SCDAS? 


, wORD 

0)2266 

t CLV 

.wORD 

0 


, w 0 R 0 

000242 


, w 0 R D 

SCI aS0 


t * 0 W 

0)2262 

;clh 

• w or o 

0 


. W O R D 

00500? 


.wORO 

SCUAS14BYTFLG 


, wORO 

0)2256 

r CL^f 

.wORO 

0 


.wORD 

000250 


.wORD 

SCLAS0 


, wORO 

012243 

i etc 

, wORO 

0 


, wORD 

000241 


, wORD 

SCU4S0 
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WORD 

011473 

» CCC 

WORD 

0 


WORD 

090257 


WORD 

5CL4S0 


WORD 

010003 

JBVS 

WORD 

0 


WORD 

102400 


WORD 

SCUS4 


WORD 

007763 

9 SVC 

WORD 

0 


WORD 

102000 


WORD 

SCU84 


WORD 

007520 

f BR 

WORD 

0 


WORD 

000400 


WORD 

SCUAS4 


WORD 

007414 

IBPL 

WORD 

0 


WORO 

100000 


WORD 

SCUS4 


WORD 

007265 

»BNE 

WORO 

0 


WORD 

001000 


WORD 

SCLAS4 


WORD 

007221 

IBM! 

WORD 

0 


WORD 

100400 


WORD 

seus4 


wORD 

007164 

1 BLT 

WORD 

0 


WORD 

002400 


WORD 

SCUS4 


WORD 

007157 

IBLOS 

mORD 

073300 


WORD 

191400 


WORD 

SC t A 54 


WORD 

007157 

1 6L0 

WORD 

0 


WORD 

103400 


WORD 

SCLAS4 
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I 


»BIE 


,w0RO 

0*7 1 45 

a 

v * QRQ 

003400 

. wORO 

$CtAS4 

, wORO 

006774 

• WORD 

0 

, WORD 

03000? 

• WORD 

5CtA$2*BYTFLG 

,«*OeO 

006773 

,wORO 

0 

.WORD 

050000 

.WORD 

SCUS2*BYTFLG 

.WORD 

006753 

• WORD 

0 

.wORQ 

040000 

• WORD 

$CU$2*BYTFLG 

• WORD 

006711 

• WORD 

073300 

• WORD 

103000 

.wORD 

Set AS4 

• WORD 

006711 

.wORD 

0 

. wORO 

101000 

• WORD 

Set AS4 

• WORD 

006654 

• WORD 

0 

• WORD 

003000 

, wORU 

set AS4 

,wQRi) 

0066,35 

. wORD 

0 

.WORD 

002000 

• wORD 

set AS4 

.WORD 

306531 

.WORD 

0 

• WORD 

001400 

.WORD 

set AS4 


I B IT 


IBIS 


I B IC 


JBHIS 


IBM! 


J 9QT 


I 8GE 


J BED 
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• WORD 

0^6413 

fBCS 

• WORD 

0 


• WORD 

103400 


• WORD 

5CIAS4 


• WORD 

006373 

f BCD 

• WORD 

0 


• WORD 

103000 


• WORD 

SCUS4 


• WORD 

004512 

f ASR 

• WORD 

0 


• WORD 

006200 


.WORD 

SCUAS1WBYTFUG 


• WORO 

004504 

MSI. 

• WORD 

0 


• WORD 

006300 


• WORD 

SCtASl wBYTFUG 


• WORD 

003344 

MOO 

a wORO 

0 


• WORD 

060000 


• WORD 

SCUS2 


• WORD 

003343 

t ADC 

• WORD 

0 


• WORD 

005500 


• WORD 

3eUSl*BYTFLG 



J 

t 

t 
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APPENDIX E 


SYSTEM ERROR MESSAGES 


Error Code 


1. Command String Semantic Errors 

1.1 Illegal switch 
Too many switches 
Illegal switch value 

Too many switch values S203 

1.2 Too many output file specifications S204 

1.3 Too many input file specifications S205 

1.4 Input file missing S206 


2. Limit Errors 


2.1 

More 

than 

376 8 .CSECT's 

S200 

2.2 

More 

than 

177 g nested conditionals 

S201 


3 . I/O Errors 

3.1 Binary or listing file structured device 

full or input command string too long 5202 

3.2 Input .TRAN error on Assembler's overlay file S207 


July, 1971 
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PIP, File Utility Package 
DEC-ll-PIDA-D 


July 1971 


Page 


Correction 


v 

1-1 


2-2 


2-3 

and 

2-4 

2-5 


Add: 3.7 Determining Free Blocks, /FR 3-9 

Add to list of PIP features: 

10. List filenames only. 

11. List only certain file(s) or groups of files. 

12. List the number of free blocks on device specified. 


Change : 

DF: 

to 

DFn : 

Disk, fixed 

head. 

unit n 

Add to 

device 

list: 

DCn : 

Disk, fixed 

head. 

unit n 




CR: 

Card reader 




Last two lines on page should read: 

When a device is not repeated in a command string, the 
current device is assumed to be the last device specified 
on the same side (input or output) of the string . 

Replace with the attached page, dated July 1971. 


Add FREE to the list of action switches in section 2.2.1. 


3-1 5th line from the bottom should read: 

copy three files... 

3-5 Replace with the attached page dated/ July 1971. 

and 

3-6 

3- 9 Replace with attached page, dated July 1971. 

4- 1 Replace entire Chapter 4 with the attached pages, 4-1 

through through 4-10, dated July 1971. 

4-4 


5-1 Add to the list of error messages: 

S252 Filename given when none allowed. 

S254 User tried to zero the system resident disk. 

1354 DK11 disk cartridge was not zeroed (illegal 

to CONFIRM:). 

A-l Add: 


/FR 

Free 

#DT1 :/FR 


List the number of free blocks 

Change : 

: DF: 

to DRn: 

Disk, 

remaining on 

fixed head. 

DECtape unit 1. 

unit n 

Add to 

device 

list : 

DCn: 

CR: 

Disk , 
Card 

fixed head, 
reader 

unit n 
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When no device is specified, the system disk is assumed as the default 
I/O device (except for /DI, /BR, /FR switches where the keyboard is 
the default output device) . When no unit number is indicated for the 
device, unit 0 is assumed. 


2.1.2 Filename Specification 

When required, the filename specification, filnam, consists of from 
one to six letters or digits, or an asterisk; all characters in excess 
of six are ignored. The asterisk can be used to represent all file 
names . 

2.1.3 Filename Extension Specification 

When required, the filename extension specification, .ext, consists 
of a period followed by from one to three letters or digits, or an 
asterisk, which represents all extensions of a named file. 

2.1.4 User Identification Code Specification 

When required, the user identification code, [uic], consists of a pair 
of octal numbers separated by a comma and enclosed by square brackets. 
(The left and right square brackets are typed using SHIFT/K and 
SHIFT/M respectively.) The left number specifies the user group and 
the right number specifies the user within the group. 

When a UIC does not appear in a command string, the UIC of the 
user specified with the DOS LOGIN command is assumed. 

2.1.5 Switch Specif ication 

When required, the switch specification, /swl : . . . , consists of a 
slash followed by one or more letters, and optionally followed by a 
value specification of octal or decimal digits separated from the 
switch name by a colon. Switch names can be of any length; however, 
only the first two characters are ever used. If a switch is unique 
with one character, only that character needs to be typed. 

2.2 SWITCHES 

PIP's non- transfer operations are selected by use of switches, and 
are entered into the command string by preceding the switch with a 
slash. If more than one switch is used, each is still preceded by 
a slash. 
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A summary of PIP's switch options is listed below: 


Switch 

Name 

Operation 

/AL 

Allocate 

Allocate a contiguous file 

/BR 

Brief Directory 

List only filenames and extensions of 
a directory 

/CO 

Contiguous 

Create a contiguous output file 

/DE 

Delete 

Delete the file 

/DI 

Directory 

List the directory or a subset of the 
directory (see Chapter 4) . 

/EN 

Enter 

Enter the User Identification Code 
(UIC) in the Master File Directory (MFD) 

/FA 

Formatted ASCII 

Transfer file in formatted ASCII mode 

/FB 

Formatted Binary 

Transfer file in formatted binary mode 

/FR 

Free 

List the number of free blocks left on 
the device specified 

/PR 

Protect 

Change protection on the file 

/RE 

Rename 

Rename the file 

/UN 

Unlock 

Unlock the User File Directory (UFD) 
to recover the file 

/ZE 

Zero 

Zero DECtape, magtape, or disk directory 


All switches must be typed as the last part of the file speci- 
fier, that is, they cannot appear before the filename on which the 
switch is to operate. Some options require a numeric value to be 
associated with the switch. For example: 

/PR 

is the switch to change the file protection code. The new protec- 
tion code would follow and be separated from /PR by a colon. For 
example, a protection change might be written as: 

#DT0: ABC/PR: 155 

which would change the protection code of file ABC on DECtape unit 0 
from whatever it was before to code 155. 

PIP's switch options can be grouped into two categories: action 
switches and qualifying switches, as explained below. 
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Unless specified, file transfers assume linked files and use the 
corresponding DOS functions to perform the action. The /CO switch is 


used only 


a PIP command should contain the contiguous specification for a merge 
operation. The /CO switch is ignored on the input side of the command 
in a file merge operation (although not in a file copy operation) . 


When /CO is encountered in the output field of a merge operation, 
the output file specified is written as a contiguous file. For example: 


#DK : ABC/CO< DTJ2f : A , B 

This command merges the files A and B on DECtape unit 0 to a single 
contiguous file, ABC, on the disk. (A fatal error occurs if this 
command is given where the file DK:ABC already exists.) 


When transferring files without combining, PIP recognizes the /CO 
switch associated with any input files and creates the corresponding 
output file as contiguous. For example, to copy 3 files (currently 
linked or contiguous) from disk and make them all contiguous on DT0 : , 
type: 


#DT0 : < ABC . DAT/CO , DEF . DAT/ CO , GHI . DAT/ CO 

Contiguous files are denoted in the directory listing by a C following 
the number of blocks for the file. 

3.2 RENAMING FILES 


The RENAME switch is provided to allow the user a means of changing the 
name of a file. The general form of the command is: 

dev : FILE . 1/RE < dev : FILE . 2 
or 

dev : FILE . l<dev : FILE . 2/RE 

which changes the name of FILE2 to FILE1 . 

As before, if no device is specified, the disk is assumed. For 
example : 

#MAIN.0BJ/RE<TESTX.0BJ 

changes the name of TESTX.OBJ to MAIN. OBJ. 

When renaming, it is mandatory that the same device be used on 
either side of the < symbol. The following is illegal: 
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#DT0:FILEl <FILE2 


because the device for FILE2 was not specified, thus the disk is 
assumed. The operation would not be performed and an error message 
would be printed on the user's terminal. The command should be writ- 
ten as : 


#DT0 : FILEl <DT0 : FILE2 

3.3 DELETING FILES 

The DELETE switch is provided to allow the user a means of deleting 
one or more files. The simple form of the command is: 

dev: f ile/DE 

For example, the command: 

#_DT0 : MAIN . LDA/DE 

would delete the file MAIN.LDA from DT0 : . 

A number of files can be deleted by specifying a sequence of 
filenames before the DELETE switch. For example, the command: 

. #MAINl , DTI : MAIN2 . OBJ , DT2 :MAIN2 . PAL/DE 

would delete all three files. 

The DELETE switch supports the asterisk in the filename or ex- 
tension fields of file specifications. The asterisk is interpreted 
as "all", as in *.PAL meaning all files with an extension of PAL. 

To delete all files with an extension of LDA from a DECtape, type: 

#DTl : * . LDA/DE 

To delete all files from the disk, type: 

#*.*/DE 

To delete all files from a DECtape, it is recommended that the ZERO 
switch be used, since that operation is much faster. 
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should now be transferred to another filename, such as: 


#DF : FI LE . NEW <FI LE . OLD 


which copies the old file and guarantees that it is in the proper 
state. The old file should then be deleted, such as: 

£DF: FILE. OLD/DE 

and the latest file can be renamed, if desired, such as: 

£DF: FILE. NAM/ RE <FILE .NEW 

A bad link can cause erroneous data to be entered in the link 
words such that the file may be linked into unknown portions of 
the disk. Thus, it will be impossible to transfer the file onto 
a back-up device. Do not attempt to delete the bad file — it would 
be disastrous to a portion of the disk. Instead, use Edit-11 and 
search for the end of the good data, write out the entire last 
buffer, and close the new output file with the EF command. The 
bad file should then be renamed to some uncommon name and left as 
it is until the disk is reinitialized. 


3.7 DETERMINING FREE BLOCKS, /FR 

The free block switch, /FR, can be used to obtain the total number of 
free blocks remaining on any file-structured device. For example: 

#DF:/FR 

causes PIP to print the number of unused blocks on the RF11 Disk. The 
system device is assumed when no device is specified. For example: 

f/FR 
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CHAPTER 4 


DIRECTORY HANDLING 


A significant number of PIP features center around the manipulation of 
files within directories and of the directories themselves. 

4 . 1. ENTERING USER IDENTIFICATION INTO DIRECTORY 

The User Identification Code (UIC) must appear in the Master File Di- 
rectory (MFD) before a user is able to create his own files on the disk 
or DECtape. This code is generally entered into the MFD by using the 
ENTER option in PIP, although the system building program creates a 
few fundamental User File Directories (UFDs) . 

The UIC of the current user of the system is passed to DOS by the 
LOGIN command. For example: 

j_LOGIN 10,11 

sets the current UIC to [10,11]. 

The UIC of the current user is obtained from DOS and written into 
a spare slot in the MFD. If no spare slots exist in the MFD, PIP prints 
a fatal error message, and no attempt is made to extend the MFD. The 
recommended sequence is then: 

^LOGIN uic 
JRUN PIP 
#DF : /EN 

This procedure is not always necessary for DECtapes because the ZERO 
switch enters the UIC of the current user when the directory is initial- 
ized . 

If a user other than the one originally zeroing the DECtape wishes 
to access files on the tape, he must enter his UIC on the DECtape or 
explicitly reference the UIC field during each reference. 

4.2 DIRECTORY LISTINGS 

A directory of all or certain selective files on any file-structured de- 
vice can be printed on the teleprinter or line printer; PIP assumes 
the teleprinter unless LP : is specified in the command string. The 
information listed in a directory is some subset of all the information 
in the User File Directory (UFD) entry for each file. 
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The full C/DI) and brief (/BR) directory switches can be used in 
various ways to determine the type and amount of information to be 
listed. The asterisk feature (see Section 4.3) can be used with 
either directory switch for added flexibility. 

4.2.1 Full Directories, /PI 

A full directory contains a title line to identify the device and UIC, 
current (logged in) date, and all filenames with extensions, number 
of blocks per file (followed by a C if the file is contiguous) , file 
creation date, and file protection code, plus the total number of blocks 
and files (for that UIC). For example: 

#/D I 


DIRECTORY DF0 : C 1 > 13 
22- JUL- 71 


MONLIS 

508C 

00 - XXX- 70 

<377> 

LINK1 1 • 0 VR 

36C 

21 - JUL-71 

<233> 

PIP • LDA 

70 

1 9-MAR- 7 1 

<233> 

FCL .PAL 

61 

21 -JUL-71 

<233 

PALI 1 R.OVR 

me 

21 -JUL-71 

<233> 

PAL 

65 

21 - J'JL-71 

<233> 

L I NX 

59 

21 -JUL-71 

< 2 3 3 > 


TOTL PLKS : 839 

TOTL FILES: 7 


Notice that the system device (DFJ3: in this case) was assumed and the 
user was logged in under UIC 1,1. 

Whenever a file is transferred onto disk or DECtape, the date in 
the directory reflects the date on which the transfer took place, not 
the date on the original file. 

The full directories of multiple devices can be obtained: 
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DTI :/DI 


£DF : ^ 


DIRECTORY DF0 : ["TTT" T" 
24- J’jL-71 


FQNL I 

R 

508C 

00 -XXX- 70 

<211 > 

LIXK1 1 • OVR 

36C 

1 7-JUL-71 

<233> 

PIP 

• LDA 

72 

1 7- JUL-71 

<233> 

ODT 1 1 R-OBJ 

51 

1 7- JUL-71 

<233> 

FCRTRN . QVL 

1 52C 

24- JUL-71 

<2 33> 

FOR TRX 

1 1 & 

24- JUL- 71 

<233> 

L INK C 

= .LDA 

96 

1 7- JUL- 1 7 

<233> 

link 

.LDA 

58 

1 7- JUL- 71 

<233> 

I T 

.LDA 

56 

1 7- JUL- 71 

<233> 

P - L C Q 

. LDA 

i 0 7 

1 7- JUL-71 

<233 

P'- L 

• LDA 

65 

1 7- JUL- 7 1 

<233> 

P- L 1 1 

R • C V R 

4J C 

1 7- JUL 71 

<233> 

LI-R 

• LDA 

41 

I 7- JUL- 71 

<233> 

FORCO 

>•' .DON 

1 1 2 C 

1 7 -JUL- 71 

<00 > 

FAFL I 5 • LDA 

555 

1 9- JUL- 71 

<233> 


F • 0 B J 

555 

1 9- JUL- 7 1 

<2 33> 

TOTL 

FLKS : 

2629 



TOTL 

FILES: 

1 6 




DIRECTORY DTI : 

[1J] 



2 & - J U L - 7 1 




F 0 R L I p .OBJ 

1 35 

0 1 -JUL- 71 

<233> 

t'AFLI'A • OBJ 

1 36 

01 -JU--71 

<233> 

IOL01 .OBJ 

1 

0 1 - JUL71 

<233 

AFFIX .OBJ 

1 

01 -JUL-71 

<233> 

DVTFO 6 .PAL 

7 

01 - JUi--71 

<233> 

FRF 17 BLKS: 

282 



rpFf FILES: 

51 




When a full DECtape directory is obtained, the listing is concluded 
with the total number of free blocks and files , whereas with a disk the 
number of used blocks and files are reported. 

The full directory listing can be limited to produce a partial 
list of specified files on one or more devices. The following example 
illustrates the use of the asterisk to list only those files with the 
extensions specified on the two devices specified. 
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#DF:*.OVRj**OBJ.»DTl :*. PAL/DI 


DF0 : 




LINK 1 1 • 0 VR 

36 C 

1 7- JUL-71 

<233> 

PALI 1 R-Ovr 

40 C 

1 7-JUL-71 

<2 33> 

ODTi i R.OEJ 

51 

1 7-JUL-71 

<233 

FAELIB .OBJ 

555 

1 9-JUL-71 

<233> 

DTI : 




DVTP0 6 • PAL 

7 

01 -JUL-71 

<233> 


Notice that the UIC, date, and number of blocks and files for that UIC 
are not reported in partial /DI listings. 

Pull information about a particular file can be obtained by speci- 
fying th.e filename and extension with the /DI switch. For example: 

#FTN000 -OVL/DI 


DK0 : 

FTN000.OVL 10C 15-JUL-71 <233> 

This obtains all information about FTN000.OVL if it is in the DK0: 
directory. (If the file is not in the directory, there is no listing, 
but no error message. Likewise, FTN0P0.OVL/BR allows the user to 
verify the existence of the file.) 

Any UIC directory on any device can be listed by specifying that 
UIC in the command to PIP. For example, if a user is logged in under 
UIC 200 , 200 , he can give the following command (the results are shown 
below) : 
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#DT1 : C 1 j 1 I/DI 


DIRECTORY DTI : C 1 .» 1 I 
21 - JUL-7 1 


FORCOM.DGN 

27C 

01 -JUL-71 

<233> 

FORTRN.08K 

23 

01 -JUL-71 

<2 3 3> 

OVL08K • LDA 

27 

01 -JUL-71 

<23 3> 

OVL 1 8K.LDA 

26 

0 1 - JUL-7 1 

<233> 

0VL28K . LDA 

23 

01 -JUL-71 

<233> 

0VL38K . LDA 

2 6 

01 -JUL-71 

<2 33> 

OVL 48 K . LDA 

28 

01 -JUL-71 

<233> 

0VL58K . LDA 

28 

01 -JUL-71 

<233> 

0VL68K • LDA 

25 

01 - JUL-71 

<2 3 3> 

FOR TRY • 1 2K 

23 

0 1 - JUL-71 

<233> 

OVL0 .LDA 

27 

01 -JUL-71 

<233> 

OVL 1 -LDA 

2 6 

01 -JUL-71 

<233> 

0VL2 .LDA 

23 

01 -JUL-71 

<233> 

0VL3 .LDA 

26 

01 -JUL-71 

<2 33> 

OVL 4 .LDA 

28 

01 -JUL-71 

<233> 

OVL 5 .LDA 

28 

01 -JUL-71 

<233> 

0VL6 -LDA 

25 

01 -JUL-71 

- <233> 

FREE ELKS: 

123 



FREE FILES: 

39 




If the user requests information on any particular file or uses the 
asterisk feature where no such file exists, no error message is given. 
The directory is considered blank; and a blank line is printed. In 
the example below there is no *.OVR file on DT0 : 


#DF ;* .OVR.» DT0 :* .OVR/DI 


DF0 : 

LINK1 1 • 0 V R 36C 21 -JUL-71 <233> 

PALI 1 R • OVR 40 C 21-JUL-71 <233> 

DT0 : 
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4.2.2 Brief Directories, /BR 


The brief directory switch can be used to list only the device name, 
filenames, and extensions. The asterisk and specific filenames can be 
used with the brief directory switch to obtain partial brief directories , 
as in section 4.2.1. The following PIP example demonstrates the cor- 
respondence between /DI and /BR directory listings. 


. OVL/DI 


r,x?! : 

100 15-JLV-71 <233> 

9C 15-JUL-71 <233> 

7C 15-JUL-71 <233> 

9C 15-JUL-71 <233> 

10C 15-JU--71 <233 

11C 15-JUL-71 <233> 

8C 15-JUL-71 <233> 


FTN000 • OVL 
FTN00 1 .OVL 
FTN002 * OVL 
FTN00 3 • OVL 
FTN'00 A • OVL 
FTN00 5 • OVL 
FTN00 6 • OVL 


#* . OVL/BR 


DK0 : 

FTN000 .OVL 
FTN001 .OVL 
FTN002 • OVL 
FTN'00 3 • OVL 
FTN03 4 . 0 VL 
FTN00 5 • OVL 
f TN006 -OVL 
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An example of the /BR switch with the system device assumed is 
shown below: 


?/PR 


DF0 : 

KONLIF 
LINK1 1 • OVR 
PIP • LDA 
FCL .PAL 
PALI 1 R • OVR 
PAL 
LINK 


Other examples of /BR switch usage are shown below: 


*FOR • F/PR 


FOR 


This is the most efficient way to verify the existence of a 
particular file on a given device. 
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#DT0 : j DTI : /BR 


FORCOi-' • DON 
FORTRR .08K 
0VL08K .LDA 
OVL 1 8K • LDA 
0VL28K.LDA 
0VL38K • LDA 
0VL-48K . LDA 
0VL58K • LDA 
0VL68K • LDA 
FORTRN • 1 2K 
OVL0 -LDA 
OVL 1 .LDA 
0VL2 .LDA 
OVL 3 -LDA 
OVL 4 .LDA 
0VL5 -LDA 
OVL 6 .LDA 

DTI : 

FORLIr -OBJ 
FAFL I P • OBJ 
IOLOl -OBJ 
DBF IN • OF J 
DVT R ^ 6 • PAL 


4.2.3 Free Blocks, /FR 

Since a full directory listing of a system disk provides the user 
only with a summary of the number of blocks used by his current UIC, 
the /FR switch is available for determinina the number of free blocks 
remaining. For example: 

*/ FR 


DFO : 

FRFF PLKS: 551 3 

This switch can be used with any device, but is generally only 
necessary with disk, as the information is not provided automatically 
with a directory listing. Further examples of the /FR switch follow: 
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#/FR 


DK3 : 

FREE BLKS: 4113 


#DF : j DT0 : /FR 


DF0 : 

FREE BLKS: 3243 
DT0 : 

FREE BLKS: 282 


4.3 ASTERISK IN DIRECTORY LISTINGS 

The asterisk (*) feature for filenames and extensions works for direc- 
tory listings, both normal and brief form. For example, the command 

_#* . PAL/BR 

gives a brief directory listing for all files on the user's disk area 
with an extension of PAL. The asterisk can appear in the filename 
field, the extension field, or both. In addition, groups of file speci- 
fiers can be arranged to provide sequential listings, as in 

#DTj2f : * . MAC , DF : FORTN . */DI 

4.4 DECTAPE AND RK.il DISK INITIALIZATION 
4 . 4. 1 DECtape 

In order to initialize a new DECtape with the basic file structure in- 
formation required by the DOS Monitor, the ZERO switch is provided. 

This switch works only on DECtape and performs no action for other 
devices . 

The function creates the permanent bit maps, the file bit maps, the 
MFD, and a UFD for the user currently running this program. 
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This switch may be used either by itself, as in: 

#DT0:/ZE 

or in combination with other switches, as in: 

£DT 0 : ONE/ ZE < DTI : A , B , C 

which zeroes DT0 : first, then creates file ONE on DT0 : by concatenat- 
ing files A, B, and C from DTI:. When used in combination with other 
switches, ZERO is performed before any other implied actions. 

4 . 4.2 RKll Disk 

The Zero switch can be used to initialize the RKll disk. As with DEC- 
tape, the following four actions occur during initialization, in the 
order shown below: 

1. The entire disk cartridge is zeroed; 

2. The first and second MFD blocks are written; 

3. The UIC of the current user (and only this UIC) is entered 
in the MFD; then 

4. Bit map blocks are written. 

The RKll disk is initialized by typing: 

#RKn:/ZE 

where n is the octal number of the appropriate cartridge (or omitted if 
RK0 is meant). PIP responds by printing: 

CONFIRM: 

to which type either H (for high-density) or L (for low-density) fol- 
lowed by the RETURN key. Should the user decide not to initialize the 
disk, he types the SPACE bar before typing the RETURN key. 

High^density cartridges are marked 2200 BPI, and low-density cart- 
ridges are marked 1100 BPI. 
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3.5 BUILDING AND RUNNING THE SEGMENTED LINKER 


3 . 5 . 1 — Running the Overlay Ed itor (LINKOB .LDA) 

The overlay builder creates the file of overlays via logical dataset 
name OVR which has the default file specifier: 


sysdev: LINKll .OVR[ login uic] <233> 


where sysdev: represents the system device, i.e. , RK:, RF:, or RC : . 

It is recommended that the creation of the file of overlays be accomp- 
lished either while 


1. logged in under [1,1] , or 

2. with the Monitor ASSIGN command overriding the logged- 
in UIC. For example: 

$AS sysdev: LINKll. OVR [1,1] ,OVR 

In either case, the overlay builder can be executed with: 

$>RUN DT0: LINKOB. LDA 

and will create the file of overlays (LINKll. OVR) on disk with a UIC 
of [1,1]. The overlay builder will then exit to the Monitor, which 
will print $. 

The Linker should then be transferred from DECtape to the Monitor 
disk area using PIP: 


$RUN PIP 
PIP V002A 


JLINK 1 , 1<DT]3 : LINKll. LDA 


3.5.2 Running the Linker 

The Linker is executed with the Monitor command RUN: 


$RUN LINK 


The Linker will search for its overlays first under the file specifier 


sysdev:LINK11.0VR[login uic] 


3-9 


and if not found, then under: 


sys dev : LINKll . OVR[ 1,1] 


3.5.3 Overlays on DEC tape 

The DECtape can be used as the overlay device. All that is required 
to accomplish this is : 


1. Make the desired file specifier change prior to run- 
ning LINKOB.LDA. That is: 


$AS DT0: LINKll. 0VR[1, 1] ,OVR 
$RUN DT0 : LINKOB . LDA 


2. Make the same file specifier change prior to running 
LINK. That is: 


$AS DT0 : LINKl 1 . 0 VR [1,1] , OVR 
$RUN LINK 
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Link-11 Linker and Libr-11 Librarian 
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Chance 


Under section 1.3, make the following additions: 

Two Absolute load modules for 8K systems 
Two Object modules for relinking 
Seven ASCII source tapes 

At top of page, insert: 

See section 3.5 for instructions on assembling, 
building and running the Linker. 

and Change version number as shown in terminal output 

to : 

LINK- 11 V0j2T5A 


Append insert page included. 


LINK-1 



HOW TO OBTAIN SOFTWARE INFORMATION 


Announcements for new and revised software, as well as programming notes, 
software problems, and documentation corrections are published by Software 
Information Service in the following newsletters. 

Digital Software News for the PDP-8 & PDP-12 
Digital Software News for the PDP-11 
Digital Software News for the PDP-9/15 Family 

These newsletters contain information applicable to software available from 
Digital's Program Library, Articles in Digital Software News update the 
cumulative Software Performance Summary which is contained in each basic 
kit of system software for new computers. To assure that the monthly Digital 
Software News is sent to the appropriate software contact at your installation, 
please check with the Software Specialist or Sales Engineer at your nearest 
Digital office. 

Questions or problems concerning Digital's Software should be reported to 
the Software Specialist. In cases where no Software Specialist is available, 
please send a Software Performance Report form with details of the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 

These forms which are provided in the software kit should be fully filled out 
and accompanied by teletype output as well as listings or tapes of the user 
program to facilitate a complete investigation. An answer will be sent to the 
individual and appropriate topics of general interest will be printed in the 
newsletter. 

Orders for new and revised software and manuals, additional Software Per- 
formance Report forms, and software price lists should be directed to the 
nearest Digital Field office or representative. U.S.A. customers may order 
directly from the Program Library in Maynard. When ordering, include the 
code number and a brief description of the software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user library 
and publishes a catalog of programs as well as the DECUSCOPE magazine 
for its members and non-members who request it. For further information 
please write to: 


DECUS 

Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 
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READER’S COMMENTS 


Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness 
of its publications. To do this effectively we need user feedback — your critical evaluation of 
this manual. 

Please comment on this manual's completeness, accuracy, organization, usability and read- 
ability. 


Did you find errors in this manual? If so, specify by page. 


How can this manual be improved? 


Other comments? 


Please state your position. 



Date: 

Name: 


Organization: 


Street: 


Department: 


City: 

State: 


Zip or Country 
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